# Amazon Product Scraper: Search Results, Prices & Reviews (`nezha/amazon-product-scraper`) Actor Scrape Amazon product data from keywords, category URLs, product URLs, or ASINs. Start with stable search-result exports for prices, ratings, and review counts, then enable full product-detail enrichment when you need deeper fields. - **URL**: https://apify.com/nezha/amazon-product-scraper.md - **Developed by:** [nezha](https://apify.com/nezha) (community) - **Categories:** E-commerce, Developer tools, Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Amazon Product Scraper: Search Results, Prices & Reviews Turn Amazon keywords, category URLs, product URLs, or ASINs into structured product data. Start with stable search-result exports for prices, ratings, and review counts, then enable full product-detail enrichment when you need deeper fields. ### What this Actor does This Actor is designed for teams that want both product discovery and product detail enrichment in one workflow. You can start from: - `keywords` for easy first runs - filtered Amazon category or search URLs for niche-focused collection - product URLs or ASINs for direct product monitoring and catalog enrichment Unlike detail-only Amazon actors, this one supports both discovery and enrichment. Its default path is a lighter and more stable search-result export, and it can also follow products for full detail records when you enable that mode. ### Quick start 1. Enter one or more `keywords` such as `wireless mouse` or `standing desk`. 2. Choose the default `marketplace`. 3. Start with `scrapeProductDetails: false` for the most stable preview run. 4. Set `maxItems` and `maxItemsPerStartUrl` deliberately for your first run. 5. Turn `scrapeProductDetails` on when you want full product records. 6. Use a marketplace-matching proxy for the most stable localized output. ### Output preview | ASIN | Title | Price | Rating | Reviews | Availability | | --- | --- | --- | --- | --- | --- | | B0BCHJ2R7S | Wireless Mouse ... | $19.99 | 4.5 out of 5 stars | 12,481 ratings | In Stock | Typical default search-result fields include: - `asin`, `title`, `productUrl`, `priceText`, `ratingText`, `reviewCountText` - `imageUrl`, `searchTerm`, `searchPage`, `searchPosition`, `isSponsored` When full product-detail mode is enabled, fields also include: - product identity: `asin`, `title`, `brand`, `productUrl`, `marketplace` - pricing and demand signals: `currentPrice`, `listPrice`, `ratingText`, `reviewCountText`, `availabilityText` - product content: `bullets`, `description`, `attributes`, `variantSummary` - category context: `breadcrumbs`, `mainCategory`, `bestSellersRank` - source context: `searchTerm`, `searchPage`, `searchPosition`, `isPrime`, `isSponsored` - media: `images`, `imageCount` If `scrapeProductDetails` is disabled, the Actor emits lightweight `search_result` records from Amazon search pages instead of following each product detail page. That lighter mode is the default because it is more stable for first-time users and public preview runs. ### Best use cases **Product research** Collect top products for a keyword or niche and compare assortment, pricing, review volume, and listing content. **Competitor tracking** Track known ASINs or URLs over time to monitor price changes, review growth, availability, and product page updates. **Catalog enrichment** Export titles, descriptions, images, bullets, and structured attributes for your own catalog workflows. **Search landscape analysis** Run broad keyword snapshots without detail crawling when you want a lighter search-result export. ### Example input ```json { "keywords": ["wireless mouse"], "marketplace": "US", "maxItems": 24, "maxItemsPerStartUrl": 24, "maxSearchPagesPerStartUrl": 2, "scrapeProductDetails": true, "includeQuestionsCount": false, "maxImages": 6, "requestDelaySecs": 2, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [], "countryCode": "US" } } ```` ### Practical notes - `keywords` is the simplest input path for new users. - `categoryOrProductUrls` is ideal when you already have filtered Amazon URLs. - `asins` is ideal for direct monitoring and enrichment. - `includeQuestionsCount` adds extra requests, so leave it off for the fastest preview run. - `scrapeProductDetails` is off by default so the first run is easier to succeed. Turn it on for full product detail enrichment. - Failed pages are stored in `FAILED_REQUESTS`. # Actor input Schema ## `keywords` (type: `array`): Recommended first-run path. Enter one or more Amazon search keywords such as 'wireless mouse', 'standing desk', or 'protein powder'. The Actor builds Amazon search URLs automatically. ## `categoryOrProductUrls` (type: `array`): Optional Amazon URLs. Paste category URLs, filtered search URLs, bestseller pages, or product URLs from any supported Amazon marketplace. ## `asins` (type: `array`): Optional known product ASINs. Use this when you already have a product list and want full product detail enrichment without search discovery. ## `marketplace` (type: `string`): Marketplace used for keyword searches and ASIN-only input. URLs keep their own marketplace automatically. ## `language` (type: `string`): Controls the Accept-Language header. Use AUTO to follow the default language of each marketplace. ## `sortBy` (type: `string`): Applied only to keyword-generated search URLs. ## `maxItems` (type: `integer`): Global output cap. Keep this low for preview runs, then set it deliberately for larger exports. ## `maxItemsPerStartUrl` (type: `integer`): Maximum products to follow or emit from each keyword or direct search URL. ## `maxSearchPagesPerStartUrl` (type: `integer`): Stops discovery after this many Amazon search pages per keyword or direct search URL. ## `scrapeProductDetails` (type: `boolean`): Recommended. When enabled, the Actor follows products from search pages and extracts full product detail records. Disable it if you only want lightweight search-result rows from search URLs. ## `includeQuestionsCount` (type: `boolean`): Follows the Amazon Q\&A page when available and adds the answered questions count. This adds extra requests, so keep it off for the fastest preview run. ## `maxImages` (type: `integer`): Maximum high-resolution image URLs to keep per product detail record. ## `maxRetries` (type: `integer`): How many times to retry blocked or failed Amazon pages before saving them to FAILED\_REQUESTS. ## `maxConcurrency` (type: `integer`): Parallel request count. Lower values are slower but usually more stable for Amazon. ## `requestDelaySecs` (type: `integer`): Small polite delay before each request to reduce blocking risk. ## `proxyConfiguration` (type: `object`): Recommended for Amazon. Use Apify Proxy and select a country that matches the marketplace when you want the most stable and localized product availability and pricing. ## Actor input object example ```json { "keywords": [ "wireless mouse" ], "categoryOrProductUrls": [ { "url": "https://www.amazon.com/s?k=wireless+mouse" } ], "asins": [ "B0BCHJ2R7S" ], "marketplace": "US", "language": "AUTO", "sortBy": "relevanceblender", "maxItems": 24, "maxItemsPerStartUrl": 24, "maxSearchPagesPerStartUrl": 2, "scrapeProductDetails": false, "includeQuestionsCount": false, "maxImages": 6, "maxRetries": 3, "maxConcurrency": 3, "requestDelaySecs": 2 } ``` # Actor output Schema ## `dataset` (type: `string`): Actor output items. ## `outputSummary` (type: `string`): Run summary output. ## `failedRequests` (type: `string`): Requests that still failed after all retries. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "keywords": [ "wireless mouse" ], "categoryOrProductUrls": [ { "url": "https://www.amazon.com/s?k=wireless+mouse" } ], "asins": [ "B0BCHJ2R7S" ], "marketplace": "US", "language": "AUTO", "sortBy": "relevanceblender", "maxItems": 24, "scrapeProductDetails": false }; // Run the Actor and wait for it to finish const run = await client.actor("nezha/amazon-product-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "keywords": ["wireless mouse"], "categoryOrProductUrls": [{ "url": "https://www.amazon.com/s?k=wireless+mouse" }], "asins": ["B0BCHJ2R7S"], "marketplace": "US", "language": "AUTO", "sortBy": "relevanceblender", "maxItems": 24, "scrapeProductDetails": False, } # Run the Actor and wait for it to finish run = client.actor("nezha/amazon-product-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "keywords": [ "wireless mouse" ], "categoryOrProductUrls": [ { "url": "https://www.amazon.com/s?k=wireless+mouse" } ], "asins": [ "B0BCHJ2R7S" ], "marketplace": "US", "language": "AUTO", "sortBy": "relevanceblender", "maxItems": 24, "scrapeProductDetails": false }' | apify call nezha/amazon-product-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=nezha/amazon-product-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Amazon Product Scraper: Search Results, Prices & Reviews", "description": "Scrape Amazon product data from keywords, category URLs, product URLs, or ASINs. Start with stable search-result exports for prices, ratings, and review counts, then enable full product-detail enrichment when you need deeper fields.", "version": "0.1", "x-build-id": "NY9byOvuTOme0s34e" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nezha~amazon-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nezha-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/nezha~amazon-product-scraper/runs": { "post": { "operationId": "runs-sync-nezha-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/nezha~amazon-product-scraper/run-sync": { "post": { "operationId": "run-sync-nezha-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": { "keywords": { "title": "Keywords", "type": "array", "description": "Recommended first-run path. Enter one or more Amazon search keywords such as 'wireless mouse', 'standing desk', or 'protein powder'. The Actor builds Amazon search URLs automatically.", "items": { "type": "string" } }, "categoryOrProductUrls": { "title": "Category, Search, or Product URLs", "type": "array", "description": "Optional Amazon URLs. Paste category URLs, filtered search URLs, bestseller pages, or product URLs from any supported Amazon marketplace.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "asins": { "title": "ASINs", "type": "array", "description": "Optional known product ASINs. Use this when you already have a product list and want full product detail enrichment without search discovery.", "items": { "type": "string" } }, "marketplace": { "title": "Default Marketplace", "enum": [ "US", "DE", "GB", "FR", "ES", "IT", "NL", "SE", "PL", "JP", "CA", "AU", "IN", "MX", "BR", "AE", "SA", "SG", "TR" ], "type": "string", "description": "Marketplace used for keyword searches and ASIN-only input. URLs keep their own marketplace automatically.", "default": "US" }, "language": { "title": "Preferred Language", "enum": [ "AUTO", "en-US", "en-GB", "de-DE", "fr-FR", "es-ES", "it-IT", "nl-NL", "pl-PL", "ja-JP" ], "type": "string", "description": "Controls the Accept-Language header. Use AUTO to follow the default language of each marketplace.", "default": "AUTO" }, "sortBy": { "title": "Keyword Search Sort Order", "enum": [ "relevanceblender", "price-asc-rank", "price-desc-rank", "review-rank", "date-desc-rank" ], "type": "string", "description": "Applied only to keyword-generated search URLs.", "default": "relevanceblender" }, "maxItems": { "title": "Max Output Records", "minimum": 1, "type": "integer", "description": "Global output cap. Keep this low for preview runs, then set it deliberately for larger exports.", "default": 48 }, "maxItemsPerStartUrl": { "title": "Max Products Per Search URL", "minimum": 1, "type": "integer", "description": "Maximum products to follow or emit from each keyword or direct search URL.", "default": 24 }, "maxSearchPagesPerStartUrl": { "title": "Max Search Pages Per URL", "minimum": 1, "type": "integer", "description": "Stops discovery after this many Amazon search pages per keyword or direct search URL.", "default": 2 }, "scrapeProductDetails": { "title": "Scrape Full Product Details", "type": "boolean", "description": "Recommended. When enabled, the Actor follows products from search pages and extracts full product detail records. Disable it if you only want lightweight search-result rows from search URLs.", "default": false }, "includeQuestionsCount": { "title": "Include Answered Questions Count", "type": "boolean", "description": "Follows the Amazon Q&A page when available and adds the answered questions count. This adds extra requests, so keep it off for the fastest preview run.", "default": false }, "maxImages": { "title": "Max Images", "minimum": 1, "maximum": 10, "type": "integer", "description": "Maximum high-resolution image URLs to keep per product detail record.", "default": 6 }, "maxRetries": { "title": "Retries Per Request", "minimum": 1, "type": "integer", "description": "How many times to retry blocked or failed Amazon pages before saving them to FAILED_REQUESTS.", "default": 3 }, "maxConcurrency": { "title": "Max Concurrency", "minimum": 1, "maximum": 8, "type": "integer", "description": "Parallel request count. Lower values are slower but usually more stable for Amazon.", "default": 3 }, "requestDelaySecs": { "title": "Delay Between Requests (Secs)", "minimum": 0, "type": "integer", "description": "Small polite delay before each request to reduce blocking risk.", "default": 2 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Recommended for Amazon. Use Apify Proxy and select a country that matches the marketplace when you want the most stable and localized product availability and pricing." } } }, "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 } } } } } } } } } } ```