# Amazon Product Scraper โ€” Search & Details (`hipersoft/amazon-product-scraper`) Actor Scrape Amazon product data from public search results and product pages: title, price, rating, reviews, image, ASIN, brand, features and availability. Multi-marketplace. No login. - **URL**: https://apify.com/hipersoft/amazon-product-scraper.md - **Developed by:** [hiper soft](https://apify.com/hipersoft) (community) - **Categories:** E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.004 / product scraped This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 & Details, Multi-Marketplace, Clean JSON, No Login Scrape Amazon product data straight from public search results and product pages โ€” title, price, rating, reviews, image, ASIN, brand, features and availability โ€” across 10 marketplaces. Results come back as clean, structured JSON you can drop into a spreadsheet, database or dashboard. No account, no API key. Built for price monitoring, catalog research, review analysis and competitive intelligence. ### Features - ๐Ÿ”Ž **Keyword search** โ€” feed any number of `searches` (e.g. "wireless earbuds") and collect up to `maxProductsPerSearch` products each, paginated automatically. - ๐Ÿท๏ธ **ASIN lookup** โ€” pass exact `asins` to pull full product pages for the products you already know. - ๐ŸŒ **10 marketplaces** โ€” set `country` to us, uk, de, fr, it, es, ca, jp, in or au; prices resolve in the correct local currency. - ๐Ÿ“„ **Optional deep detail** โ€” flip `includeProductDetails` on to enrich each result with brand, features, description, category and extra images. - ๐Ÿ’ฐ **Real pricing signals** โ€” captures `price`, `listPrice`, `currency`, plus `rating`, `reviewsCount`, `isPrime` and `sponsored` flags. - ๐Ÿ›ก๏ธ **Residential proxy built in** โ€” Amazon blocks datacenter IPs, so the scraper defaults to residential proxies with automatic session rotation on blocks and captchas. - ๐Ÿงพ **Clean JSON output** โ€” every record is flat and ready to export to CSV, Excel, JSON or an API. ### What you get One record per product (search results shown; enable details for the extra fields): ```json { "search": "wireless earbuds", "asin": "B08N5WRWNW", "title": "Wireless Earbuds Bluetooth 5.3 Headphones", "url": "https://www.amazon.com/dp/B08N5WRWNW", "price": 29.99, "currency": "$", "listPrice": 49.99, "rating": 4.4, "reviewsCount": 12873, "image": "https://m.media-amazon.com/images/I/61abc.jpg", "sponsored": false, "isPrime": true } ```` ### Input ```json { "searches": ["wireless earbuds", "yoga mat"], "asins": ["B08N5WRWNW"], "maxProductsPerSearch": 60, "includeProductDetails": false, "country": "us", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ``` | Field | Description | | --- | --- | | `searches` | Search keywords; each is scraped for products. | | `asins` | Specific product ASINs to fetch as full product pages. | | `maxProductsPerSearch` | Max products per keyword (1โ€“1000, default 60). | | `includeProductDetails` | Fetch each product page for brand, features and description (slower). | | `country` | Amazon marketplace (us, uk, de, fr, it, es, ca, jp, in, au). | | `proxyConfiguration` | Proxy settings; residential is required and on by default. | ### Use cases - Track competitor prices and discounts across a category over time. - Build and enrich a product catalog with ratings, images and features. - Mine review counts and star ratings for product and market research. - Monitor a marketplace by keyword to spot new or trending listings. ### Pricing Pay-per-event: you're billed a small amount per run and per item scraped โ€” you only pay for what you get. See the **Pricing** tab for current rates. ### Notes This scraper only reads publicly available Amazon search and product pages โ€” no login-walled content, accounts or private data. It is an independent tool and is not affiliated with, authorized or endorsed by Amazon; "Amazon" and related marks belong to their respective owners. # Actor input Schema ## `searches` (type: `array`): Amazon search terms. Each is scraped for products. ## `asins` (type: `array`): Look up specific products by ASIN (e.g. B08N5WRWNW). Fetched as full product pages. ## `maxProductsPerSearch` (type: `integer`): Maximum products to collect per search keyword. ## `includeProductDetails` (type: `boolean`): Fetch each search result's product page for brand, features, description and images (slower). ## `country` (type: `string`): Amazon marketplace. ## `proxyConfiguration` (type: `object`): Proxy. Residential is REQUIRED โ€” Amazon blocks datacenter IPs. ## Actor input object example ```json { "searches": [ "laptop stand", "yoga mat" ], "asins": [ "B08N5WRWNW" ], "maxProductsPerSearch": 60, "includeProductDetails": false, "country": "us", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # 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 = { "searches": [ "wireless earbuds" ] }; // Run the Actor and wait for it to finish const run = await client.actor("hipersoft/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 = { "searches": ["wireless earbuds"] } # Run the Actor and wait for it to finish run = client.actor("hipersoft/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 '{ "searches": [ "wireless earbuds" ] }' | apify call hipersoft/amazon-product-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=hipersoft/amazon-product-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Amazon Product Scraper โ€” Search & Details", "description": "Scrape Amazon product data from public search results and product pages: title, price, rating, reviews, image, ASIN, brand, features and availability. Multi-marketplace. No login.", "version": "1.0", "x-build-id": "wD3QBgbXjDPDdKAnA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/hipersoft~amazon-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-hipersoft-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/hipersoft~amazon-product-scraper/runs": { "post": { "operationId": "runs-sync-hipersoft-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/hipersoft~amazon-product-scraper/run-sync": { "post": { "operationId": "run-sync-hipersoft-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": { "searches": { "title": "Search keywords", "type": "array", "description": "Amazon search terms. Each is scraped for products.", "items": { "type": "string" } }, "asins": { "title": "ASINs", "type": "array", "description": "Look up specific products by ASIN (e.g. B08N5WRWNW). Fetched as full product pages.", "items": { "type": "string" } }, "maxProductsPerSearch": { "title": "Max products per search", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum products to collect per search keyword.", "default": 60 }, "includeProductDetails": { "title": "Include full product details", "type": "boolean", "description": "Fetch each search result's product page for brand, features, description and images (slower).", "default": false }, "country": { "title": "Marketplace", "enum": [ "us", "uk", "de", "fr", "it", "es", "ca", "jp", "in", "au" ], "type": "string", "description": "Amazon marketplace.", "default": "us" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Proxy. Residential is REQUIRED โ€” Amazon blocks datacenter IPs.", "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 } } } } } } } } } } ```