# Amazon Product Scraper (`leftwinglautus/amazon-product-scraper`) Actor Scrapes Amazon product search results by keyword. Returns product titles, prices, ratings, reviews, images, ASINs, and Prime eligibility. - **URL**: https://apify.com/leftwinglautus/amazon-product-scraper.md - **Developed by:** [Moeeze Hassan](https://apify.com/leftwinglautus) (community) - **Categories:** E-commerce, AI - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 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 Scrape [Amazon](https://www.amazon.com/) product search results by keyword. The actor supports multiple Amazon marketplaces (`.com`, `.co.uk`, `.de`, `.fr`), result sorting, minimum rating filtering, and User-Agent rotation to reduce the chance of being blocked. It returns structured product data including title, price, rating, review count, image URL, ASIN, and Prime eligibility. ### Features - Keyword-based product search across four Amazon marketplaces - Sort by relevance, price (low-to-high / high-to-low), or rating - Minimum star-rating filter (1–5) - Rotating User-Agent strings to avoid blocking - Extracts price, original price, currency, rating, review count, image, ASIN, and Prime status ### Input Fields | Field | Type | Required | Default | Description | | --- | --- | --- | --- | --- | | `keyword` | string | ✅ | `""` | The search term to look up on Amazon. | | `maxResults` | integer | ❌ | `20` | Maximum number of products to return (1–200). | | `sortBy` | string (enum) | ❌ | `relevance` | How to sort results: `relevance`, `price-low`, `price-high`, or `rating`. | | `minRating` | integer | ❌ | `0` | Only return products with at least this rating (1–5). `0` means no filter. | | `country` | string (enum) | ❌ | `com` | Amazon marketplace country code: `com`, `co.uk`, `de`, or `fr`. | ### Output Fields Each pushed dataset item is a product record with the following fields: | Field | Type | Description | | --- | --- | --- | | `title` | string | Product title. | | `price` | number \| null | Current price (numeric). | | `originalPrice` | number \| null | Original / list price (strikethrough), if shown. | | `currency` | string \| null | Currency symbol (e.g. `$`, `£`, `€`). | | `rating` | number \| null | Star rating (1–5). | | `reviewCount` | integer \| null | Number of customer reviews. | | `url` | string \| null | Direct URL to the product page. | | `imageUrl` | string \| null | URL to the product image. | | `isPrime` | boolean | Whether the product is Prime-eligible. | | `asin` | string | Amazon Standard Identification Number (ASIN). | ### Usage Example #### Search for "wireless earbuds" on Amazon.com ```json { "keyword": "wireless earbuds", "maxResults": 20, "sortBy": "relevance", "country": "com" } ```` #### Get the cheapest "mechanical keyboard" on Amazon UK ```json { "keyword": "mechanical keyboard", "maxResults": 30, "sortBy": "price-low", "country": "co.uk" } ``` #### Find top-rated "coffee grinder" products with 4+ stars ```json { "keyword": "coffee grinder", "maxResults": 20, "sortBy": "rating", "minRating": 4, "country": "com" } ``` #### Run via the Apify CLI ```bash apify run amazon-product-scraper --input '{"keyword":"wireless earbuds","maxResults":20,"country":"com"}' ``` ### Notes - The actor parses the first page of Amazon search results. Amazon frequently changes its page structure; the scraper uses multiple CSS selectors and a fallback to maintain resilience. - Prices and ratings are parsed from the search result cards and may not reflect the full product detail page. - User-Agent rotation helps, but Amazon may still block automated requests. If results are empty, try again later or reduce the request frequency. ### Data Source Products are scraped from Amazon search pages (`/s?k=`) using BeautifulSoup to parse the rendered HTML. # Actor input Schema ## `keyword` (type: `string`): The search term to look up on Amazon. ## `maxResults` (type: `integer`): Maximum number of products to return. ## `sortBy` (type: `string`): How to sort Amazon search results. ## `minRating` (type: `integer`): Only return products with at least this rating (1-5). 0 means no filter. ## `country` (type: `string`): Amazon marketplace country code. ## Actor input object example ```json { "keyword": "", "maxResults": 20, "sortBy": "relevance", "minRating": 0, "country": "com" } ``` # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("leftwinglautus/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 = {} # Run the Actor and wait for it to finish run = client.actor("leftwinglautus/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 '{}' | apify call leftwinglautus/amazon-product-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=leftwinglautus/amazon-product-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Amazon Product Scraper", "description": "Scrapes Amazon product search results by keyword. Returns product titles, prices, ratings, reviews, images, ASINs, and Prime eligibility.", "version": "0.1", "x-build-id": "7YqKxQcoEhg3FENYf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/leftwinglautus~amazon-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-leftwinglautus-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/leftwinglautus~amazon-product-scraper/runs": { "post": { "operationId": "runs-sync-leftwinglautus-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/leftwinglautus~amazon-product-scraper/run-sync": { "post": { "operationId": "run-sync-leftwinglautus-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", "required": [ "keyword" ], "properties": { "keyword": { "title": "Search keyword", "type": "string", "description": "The search term to look up on Amazon.", "default": "" }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum number of products to return.", "default": 20 }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "price-low", "price-high", "rating" ], "type": "string", "description": "How to sort Amazon search results.", "default": "relevance" }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "integer", "description": "Only return products with at least this rating (1-5). 0 means no filter.", "default": 0 }, "country": { "title": "Country", "enum": [ "com", "co.uk", "de", "fr" ], "type": "string", "description": "Amazon marketplace country code.", "default": "com" } } }, "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 } } } } } } } } } } ```