{ "openapi": "3.0.1", "info": { "title": "Amazon Scraper — Cheapest Price Finder Across 23 Marketplaces", "description": "Find the cheapest Amazon prices across 23 marketplaces. Scrape ASINs, titles, prices, URLs, images, sponsored flags, and search rank positions by keyword. Up to 10,000 products per run. Export to CSV, JSON, or Excel. No Amazon PA-API needed.", "version": "1.8", "x-build-id": "twEgwlnGiyFv451Xh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapeio~cheapest-amazon-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapeio-cheapest-amazon-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/scrapeio~cheapest-amazon-scraper/runs": { "post": { "operationId": "runs-sync-scrapeio-cheapest-amazon-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/scrapeio~cheapest-amazon-scraper/run-sync": { "post": { "operationId": "run-sync-scrapeio-cheapest-amazon-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "keyword": { "title": "Amazon search keyword", "type": "string", "description": "Product, brand, category, or long-tail Amazon search query, e.g. wireless earbuds, protein powder, running shoes for women." }, "maxResults": { "title": "Max products to collect", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Number of unique Amazon product rows / ASINs to collect. The actor paginates automatically until it reaches this count or listings end.", "default": 25 }, "marketplace": { "title": "Amazon marketplace", "enum": [ "US", "CA", "MX", "BR", "UK", "DE", "FR", "IT", "ES", "NL", "BE", "SE", "PL", "TR", "AE", "SA", "EG", "IN", "JP", "AU", "SG", "IE", "ZA" ], "type": "string", "description": "Country / region storefront to search. Ignored when Custom Amazon base URL is provided.", "default": "IN" }, "baseUrl": { "title": "Custom Amazon base URL", "type": "string", "description": "Optional advanced override, e.g. https://www.amazon.com, https://www.amazon.co.uk, or another Amazon retail domain. Overrides the marketplace dropdown." }, "city": { "title": "Reporting label", "type": "string", "description": "Optional label stored in OUTPUT only. It does not change Amazon geography; marketplace or baseUrl controls that." }, "callQueryApi": { "title": "Use Amazon /s/query XHR", "type": "boolean", "description": "Advanced. If unset, it is enabled automatically only for amazon.in. Set true to attempt /s/query on any marketplace, or false to use standard search pages only." }, "wIndexMainSlot": { "title": "wIndexMainSlot", "minimum": 0, "type": "integer", "description": "Advanced body field used by Amazon /s/query when enabled.", "default": 75 }, "queryExtraParams": { "title": "Extra /s/query URL parameters", "type": "string", "description": "Optional DevTools query string fragment copied from Amazon /s/query after k, page, dc, qid, and ds." }, "cookieHeader": { "title": "Cookie header", "type": "string", "description": "Optional raw Cookie header for sessions where Amazon returns challenges, 503 responses, or localized prices you need to preserve." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Use Apify Proxy, preferably RESIDENTIAL for large Amazon scraping jobs or regions returning HTTP 503 / empty pages.", "default": { "useApifyProxy": false } }, "k": { "title": "Keyword (API alias)", "type": "string", "description": "Same as Amazon search keyword. Prefer keyword for new integrations." }, "numberOfResults": { "title": "Max products (alias)", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Same as Max products to collect. Prefer maxResults for new integrations." }, "resultsRequired": { "title": "Results required (alias)", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Same as Max products to collect. Prefer maxResults for new integrations." }, "country": { "title": "Marketplace country code (alias)", "type": "string", "description": "Same as Amazon marketplace, e.g. US, UK, IN, DE. Prefer marketplace for new integrations." }, "region": { "title": "Marketplace region code (alias)", "type": "string", "description": "Same as Amazon marketplace, e.g. US, UK, IN, DE. Prefer marketplace for new integrations." }, "domain": { "title": "Custom Amazon domain (alias)", "type": "string", "description": "Same as Custom Amazon base URL. Prefer baseUrl for new integrations." }, "deliveryCity": { "title": "Reporting label (alias)", "type": "string", "description": "Same as Reporting label. Stored in output only." }, "cookies": { "title": "Cookies (alias)", "type": "string", "description": "Same as Cookie header. Prefer cookieHeader for new integrations." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }