{ "openapi": "3.0.1", "info": { "title": "Amazon Product Scraper", "description": "Scrape Amazon products from search URLs, category URLs, ASINs, or seller stores. Each row ships pricing (list, savings, coupons), seller intel (FBA vs FBM, buy box), BSR, variants, ratings histogram, badges, and stock signals. 10 marketplaces. Pay per product.", "version": "0.1", "x-build-id": "Mby48no5P2HxOmjed" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapemint~amazon-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapemint-amazon-product-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/scrapemint~amazon-product-scraper/runs": { "post": { "operationId": "runs-sync-scrapemint-amazon-product-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/scrapemint~amazon-product-scraper/run-sync": { "post": { "operationId": "run-sync-scrapemint-amazon-product-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": { "startUrls": { "title": "Amazon URLs", "type": "array", "description": "Amazon search URLs (/s?k=), category URLs (/b?node= or /gp/bestsellers), product URLs (/dp/ASIN), or seller store URLs (/stores/ or /shops/). Mix and match. Each is treated as an entry point.", "default": [], "items": { "type": "string" } }, "asins": { "title": "Direct ASINs (alternative input)", "type": "array", "description": "List of 10 character Amazon ASINs to scrape directly. Skip if you are using URLs. Combined with the marketplace below.", "default": [], "items": { "type": "string" } }, "marketplace": { "title": "Marketplace for direct ASINs", "enum": [ "US", "UK", "DE", "FR", "IT", "ES", "CA", "AU", "JP", "IN" ], "type": "string", "description": "Amazon marketplace used when ASINs are passed directly. Search and category URLs already carry their own marketplace.", "default": "US" }, "maxResultsPerStartUrl": { "title": "Max results per start URL", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Hard cap on products returned per search or category URL. 0 means everything Amazon exposes (typically up to 7 pages of 16 results).", "default": 25 }, "extractVariants": { "title": "Extract variant matrix", "type": "boolean", "description": "Pull all child ASINs, sizes, colors, and price points for products that ship in multiple variants. Built in. No extra cost.", "default": true }, "extractBSR": { "title": "Extract Best Sellers Rank", "type": "boolean", "description": "Pull BSR by category for every product. Includes primary and subcategory ranks. Useful for product researchers and FBA sourcing.", "default": true }, "extractRatingHistogram": { "title": "Extract rating histogram", "type": "boolean", "description": "Capture the percentage split across 5, 4, 3, 2, and 1 star reviews. Adds 200 to 400 ms per product.", "default": true }, "extractFrequentlyBoughtTogether": { "title": "Extract frequently bought together", "type": "boolean", "description": "Capture the FBT bundle ASINs and total bundle price.", "default": false }, "extractAPlusContent": { "title": "Extract A+ content", "type": "boolean", "description": "Capture the brand A+ content blocks (rich product description with images and comparison tables).", "default": false }, "deliveryZipcode": { "title": "Delivery zipcode", "type": "string", "description": "US zipcode used to set the delivery location cookie. Affects pricing and shipping estimates. Leave blank to use Amazon's default.", "default": "" }, "dedupe": { "title": "Deduplicate across runs", "type": "boolean", "description": "Skip ASINs already pushed in previous runs. Turn off to refresh stale rows.", "default": true }, "concurrency": { "title": "Concurrency", "minimum": 1, "maximum": 12, "type": "integer", "description": "Number of products processed in parallel. Three to four is safe. Higher concurrency triggers Amazon CAPTCHAs faster.", "default": 3 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy. Residential is required for Amazon at any meaningful volume.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }