example.php

<?php
/**
 * Amazon Scraper — Scrapeless Scraping API (PHP example)
 *
 * Docs:  https://apidocs.scrapeless.com/doc-857373
 * Token: https://app.scrapeless.com/passport/login?redirect=/quick-start
 *
 * The Amazon actor supports four scrape types selected via `input.type`:
 *   product | seller | keywords | rufus
 *
 * Run (requires the php-curl extension):
 *   export SCRAPELESS_API_TOKEN="your_api_token"
 *   php example.php            # defaults to the "product" type
 *   php example.php keywords   # or pass a type: product | seller | keywords | rufus
 */

$apiUrl = "https://api.scrapeless.com/api/v1/scraper/request";
$apiToken = getenv("SCRAPELESS_API_TOKEN") ?: "YOUR_API_TOKEN";

// Ready-to-use input payloads for each scrape type.
$sampleInputs = [
    "product" => [
        "type"     => "product",
        "url"      => "https://www.amazon.com/dp/B0BQXHK363",
        "zip_code" => "",
    ],
    "seller" => [
        "type"     => "seller",
        "url"      => "https://www.amazon.com/sp?seller=A2XZ7JICGUQ1CX",
        "zip_code" => "",
    ],
    "keywords" => [
        "type"     => "keywords",
        "keywords" => "Iphone+14+Pro+512GB",
        "page"     => "1",
        "domain"   => "com",
        "zip_code" => "",
    ],
    "rufus" => [
        "type"     => "rufus",
        "keywords" => "macbook",
        "domain"   => "www.amazon.es",
        "page"     => "1",
    ],
];

$scrapeType = $argv[1] ?? "product";
if (!isset($sampleInputs[$scrapeType])) {
    fwrite(STDERR, "Unknown type '{$scrapeType}'. Choose one of: product, seller, keywords, rufus\n");
    exit(1);
}

$payload = ["actor" => "scraper.amazon", "input" => $sampleInputs[$scrapeType]];

$ch = curl_init($apiUrl);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_TIMEOUT        => 180,
    CURLOPT_HTTPHEADER     => [
        "Content-Type: application/json",
        "x-api-token: " . $apiToken,
    ],
    CURLOPT_POSTFIELDS => json_encode($payload),
]);

$response = curl_exec($ch);
if ($response === false) {
    fwrite(STDERR, "Request failed: " . curl_error($ch) . PHP_EOL);
    exit(1);
}
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

// The Amazon actor distinguishes scenarios by HTTP status code.
switch ($status) {
    case 200:
        // Synchronous success: the body is the scraped data (shape depends on type).
        $data = json_decode($response, true);
        echo "[200] Success — '{$scrapeType}' data received." . PHP_EOL;
        if ($scrapeType === "product") {
            echo "  ASIN:  " . ($data["asin"] ?? "") . PHP_EOL;
            echo "  Brand: " . ($data["brand"] ?? "") . PHP_EOL;
            echo "  Price: " . ($data["final_price"] ?? "") . "  (" . ($data["availability"] ?? "") . ")" . PHP_EOL;
        } elseif ($scrapeType === "keywords") {
            $organic = $data["result"]["organic"] ?? [];
            echo "  keyword: " . ($data["keyword"] ?? "") . " page: " . ($data["page"] ?? "") .
                 " — " . count($organic) . " organic results" . PHP_EOL;
            foreach (array_slice($organic, 0, 3) as $item) {
                echo "    - " . ($item["title"] ?? "") . " :: " . ($item["price"] ?? "") . PHP_EOL;
            }
        }
        echo PHP_EOL . "  Raw response (truncated to 1500 chars):" . PHP_EOL;
        echo "  " . substr($response, 0, 1500) . PHP_EOL;
        break;

    case 201:
        // Task accepted but still running. Retrieve it later by task id (see docs).
        $body = json_decode($response, true);
        echo "[201] Task in progress — message: " . ($body["message"] ?? "") .
             ", taskId: " . ($body["taskId"] ?? "") . PHP_EOL;
        echo "      Fetch the result later using the task id (see docs)." . PHP_EOL;
        break;

    case 400:
        // Scraping failed — inspect the error code and message.
        $body = json_decode($response, true);
        echo "[400] Bad request — code: " . ($body["code"] ?? "") .
             ", message: " . ($body["message"] ?? "") . PHP_EOL;
        break;

    default:
        echo "[{$status}] Unexpected response:" . PHP_EOL . $response . PHP_EOL;
        exit(1);
}