{ "openapi": "3.0.1", "info": { "title": "Amazon Scraper - Product Prices, BSR & Sales Estimates", "description": "Scrape Amazon products by keyword, product link or ASIN in 20 Amazon stores: price, Best Sellers Rank, monthly sales and revenue estimates, rating, review count, badges, variants and specs. No login. Export to CSV, JSON or Excel, schedule runs or use the API.", "version": "0.1", "x-build-id": "QukY57ND30KugfHnZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automly~amazon-products-scraper---fast-efficient-with-sales-data/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automly-amazon-products-scraper---fast-efficient-with-sales-data", "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/automly~amazon-products-scraper---fast-efficient-with-sales-data/runs": { "post": { "operationId": "runs-sync-automly-amazon-products-scraper---fast-efficient-with-sales-data", "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/automly~amazon-products-scraper---fast-efficient-with-sales-data/run-sync": { "post": { "operationId": "run-sync-automly-amazon-products-scraper---fast-efficient-with-sales-data", "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": { "keywords": { "title": "Keywords (search mode)", "uniqueItems": true, "type": "array", "description": "Words to search Amazon for, one per line, e.g. garlic press or wireless earbuds. Each keyword returns up to Max results per keyword products. Leave empty if you only want the product links or ASINs below.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs (direct product URLs)", "uniqueItems": true, "type": "array", "description": "Amazon product links, one per line, e.g. https://www.amazon.com/dp/B07YNMTKXP. Can be used together with keywords and ASINs.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "asins": { "title": "ASINs", "uniqueItems": true, "type": "array", "description": "Amazon product IDs (ASINs, 10 characters), one per line, e.g. B07YNMTKXP. They are looked up in the Marketplace chosen below.", "items": { "type": "string" } }, "maxResultsPerKeyword": { "title": "Max results per keyword", "minimum": 1, "maximum": 500, "type": "integer", "description": "How many products to get for each keyword, e.g. 20. More results pages are read until this many products are found or the results end.", "default": 50 }, "fullDetails": { "title": "Full per-product detail", "type": "boolean", "description": "On (default): open each product page for best sellers rank, badges, specs, variants and monthly sales estimates. Off: keyword searches return only the search-card fields (ASIN, title, price, rating, image, sponsored flag), much faster but without ranks or sales estimates.", "default": true }, "marketplace": { "title": "Marketplace", "enum": [ "com", "co.uk", "de", "fr", "it", "es", "ca", "com.mx", "in", "com.br", "co.jp", "com.au", "ae", "sa", "nl", "se", "pl", "com.tr", "sg", "eg" ], "type": "string", "description": "Which Amazon store to scrape. Products are read as a shopper in that country sees them: local language, local currency and local delivery. Sales estimates are available for amazon.com, .co.uk, .de, .fr, .it, .es, .ca, .com.mx and .in.", "default": "com" }, "concurrency": { "title": "Run speed", "minimum": 1, "maximum": 16, "type": "integer", "description": "Higher is faster. The default works for most runs.", "default": 16 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "The default works for most runs. If results come back empty, try a different proxy option.", "default": { "useApifyProxy": true } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }