{ "openapi": "3.0.1", "info": { "title": "Amazon Multi Marketplace Scraper [Most Advance]", "description": "Scrape Amazon search results across 23 marketplaces (US, UK, India, Germany, Japan, UAE, and more) in one run. Extract ASINs, titles, prices, URLs, images, sponsored flags, and exact search ranking position. Up to 10,000 products per run. Export to CSV or JSON. No Amazon Associates or PA‑API account", "version": "1.7", "x-build-id": "HyrhZFMWM0w0uj2WQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapeio~amazon-multi-marketplace-scraper-most-advanced/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapeio-amazon-multi-marketplace-scraper-most-advanced", "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~amazon-multi-marketplace-scraper-most-advanced/runs": { "post": { "operationId": "runs-sync-scrapeio-amazon-multi-marketplace-scraper-most-advanced", "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~amazon-multi-marketplace-scraper-most-advanced/run-sync": { "post": { "operationId": "run-sync-scrapeio-amazon-multi-marketplace-scraper-most-advanced", "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", "required": [ "keyword", "maxResults" ], "properties": { "keyword": { "title": "Search keyword", "type": "string", "description": "Search query (Amazon k= parameter)." }, "maxResults": { "title": "Number of results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "How many unique products to collect (1–10000). Pagination is automatic.", "default": 25 }, "marketplace": { "title": "Amazon marketplace (country / region)", "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": "Retail storefront to search. Ignored if you set baseUrl below.", "default": "IN" }, "baseUrl": { "title": "Custom Amazon base URL (advanced)", "type": "string", "description": "Optional. Overrides marketplace dropdown, e.g. https://www.amazon.com or a regional Amazon domain." }, "city": { "title": "Location note (optional)", "type": "string", "description": "Stored in output for your records only; does not change search geography (marketplace does)." }, "callQueryApi": { "title": "POST /s/query (page 1)", "type": "boolean", "description": "Browser-style XHR. If omitted: enabled only for amazon.in; set false to skip, true to attempt on any marketplace." }, "wIndexMainSlot": { "title": "wIndexMainSlot", "minimum": 0, "type": "integer", "description": "Body field for /s/query when enabled.", "default": 75 }, "queryExtraParams": { "title": "Extra /s/query URL params", "type": "string", "description": "Optional DevTools string (after k, page, dc, qid, ds)." }, "cookieHeader": { "title": "Cookie header (optional)", "type": "string", "description": "Optional Cookie header for difficult sessions." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Use Apify Proxy (ideally RESIDENTIAL) when Amazon returns HTTP 503 or empty pages from datacenter IPs. Set useApifyProxy to true and pick groups/country in the editor.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }