{ "openapi": "3.0.1", "info": { "title": "Amazon Scraper API & Price Monitor (21 Markets)", "description": "Scrape Amazon product data by ASIN or keyword across 21 marketplaces, or run it on a schedule to track price, Buy Box and stock changes since the last check. Returns clean JSON with title, price, rating, seller and availability. No HTML captchas, no vendor account.", "version": "0.1", "x-build-id": "4NUcxoiQ0b3h0Pf0z" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/winningsolutions~amazon-product-scraper-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-winningsolutions-amazon-product-scraper-monitor", "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/winningsolutions~amazon-product-scraper-monitor/runs": { "post": { "operationId": "runs-sync-winningsolutions-amazon-product-scraper-monitor", "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/winningsolutions~amazon-product-scraper-monitor/run-sync": { "post": { "operationId": "run-sync-winningsolutions-amazon-product-scraper-monitor", "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": [ "marketplaces" ], "properties": { "mode": { "title": "Input mode", "enum": [ "asin", "keyword" ], "type": "string", "description": "Choose ASIN list or Product search. Example: asin", "default": "asin" }, "asins": { "title": "Amazon ASINs", "type": "array", "description": "One ASIN per row. Example: B09V3KXJPB", "items": { "type": "string", "pattern": "^[A-Za-z0-9]{10}$" } }, "keywords": { "title": "Search keywords", "type": "array", "description": "One keyword per row. Example: wireless earbuds", "items": { "type": "string" } }, "maxProductsPerKeyword": { "title": "Max products per keyword", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum products to resolve per keyword and marketplace. Example: 20", "default": 20 }, "searchOnly": { "title": "Search only", "type": "boolean", "description": "Stop after Product Search. No Monitor in this run. Example: false", "default": false }, "department": { "title": "Department", "enum": [ "Arts & Crafts", "Automotive", "Baby", "Beauty & Personal Care", "Books", "Computers", "Digital Music", "Electronics", "Kindle Store", "Prime Video", "Women's Fashion", "Men's Fashion", "Girls' Fashion", "Boys' Fashion", "Deals", "Health & Household", "Home & Kitchen", "Industrial & Scientific", "Luggage", "Movies & TV", "Music, CDs & Vinyl", "Pet Supplies", "Software", "Sports & Outdoors", "Tools & Home Improvement", "Toys & Games", "Video Games" ], "type": "string", "description": "Amazon department name in English. Applies to Product search. Example: Electronics" }, "priceMin": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "Minimum price in the marketplace currency. Example: 20" }, "priceMax": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "Maximum price in the marketplace currency. Example: 80" }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "price_low_to_high", "price_high_to_low", "featured", "avg_customer_review", "newest_arrival" ], "type": "string", "description": "Sort Product Search results. Example: price_low_to_high" }, "marketplaces": { "title": "Marketplaces", "type": "array", "description": "Each ASIN is checked on every selected marketplace. EU codes appear first. Example: DE", "items": { "type": "string", "enum": [ "DE", "FR", "IT", "ES", "GB", "NL", "PL", "SE", "BE", "US", "CA", "MX", "BR", "AU", "JP", "IN", "SG", "AE", "SA", "TR", "EG" ], "enumTitles": [ "Germany (amazon.de)", "France (amazon.fr)", "Italy (amazon.it)", "Spain (amazon.es)", "UK (amazon.co.uk)", "Netherlands (amazon.nl)", "Poland (amazon.pl)", "Sweden (amazon.se)", "Belgium (amazon.com.be)", "USA (amazon.com)", "Canada (amazon.ca)", "Mexico (amazon.com.mx)", "Brazil (amazon.com.br)", "Australia (amazon.com.au)", "Japan (amazon.co.jp)", "India (amazon.in)", "Singapore (amazon.sg)", "UAE (amazon.ae)", "Saudi Arabia (amazon.sa)", "Turkiye (amazon.com.tr)", "Egypt (amazon.eg)" ] }, "default": [ "DE" ] }, "languageCode": { "title": "Language override", "type": "string", "description": "Override language_code for all selected markets. Example: fr_FR for Belgium French" }, "locationName": { "title": "Postal or city location", "type": "string", "description": "Optional location_name for delivery-sensitive prices. Example: 1050,Brussels,Belgium" }, "monitorId": { "title": "Monitor ID", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$", "type": "string", "description": "Stable ID for named-store baselines across scheduled runs. Example: eu-core", "default": "default" }, "outputMode": { "title": "Output mode", "enum": [ "full", "changes_only", "full_with_changes" ], "type": "string", "description": "Control which records are saved. Example: full_with_changes", "default": "full_with_changes" }, "trackPriceHistory": { "title": "Track price history", "type": "boolean", "description": "Store price history in the named key-value store.", "default": true }, "maxHistoryDays": { "title": "Max history days", "minimum": 7, "maximum": 365, "type": "integer", "description": "Days of price history to retain. Example: 90", "default": 90 }, "priceChangeThreshold": { "title": "Price change threshold (%)", "minimum": 0, "maximum": 100, "type": "number", "description": "Minimum percent change to flag priceChanged. Zero means any change. Example: 0", "default": 0 }, "includeSellers": { "title": "Include sellers", "type": "boolean", "description": "Fetch offers. Required for featured-offer change tracking. Adds one sellers task per ASIN and marketplace.", "default": false }, "maxSellersPerProduct": { "title": "Max sellers per product", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum sellers to keep per product. Example: 10", "default": 10 }, "includeProductDetails": { "title": "Include product details", "type": "boolean", "description": "Call the ASIN endpoint for images, attributes, and variant list. Disable for price-only runs.", "default": true }, "expandVariants": { "title": "Expand variants", "type": "boolean", "description": "If the ASIN is a parent, also monitor child ASINs from product_asins.", "default": false }, "maxVariantsPerProduct": { "title": "Max variants per product", "minimum": 1, "maximum": 50, "type": "integer", "description": "Cap child ASINs when expandVariants is enabled. Example: 10", "default": 10 }, "maxTotalChargeUsd": { "title": "Max total charge (USD)", "minimum": 0.05, "type": "number", "description": "Stop new pay-per-event charges when this amount is reached. Example: 25", "default": 25 } } }, "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 } } } } } } } } } }