# Amazon Product Scraper: Prices, BSR, Ratings & Seller Data (`johnatan029/amazon-product-scraper`) Actor Scrapes Amazon search/category results across 7 marketplaces (US, UK, DE, CA, FR, IT, ES): price, rating, review count, images and listing data. Public data, no login. - **URL**: https://apify.com/johnatan029/amazon-product-scraper.md - **Developed by:** [Johnatan Pereira](https://apify.com/johnatan029) (community) - **Categories:** E-commerce, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.00 / 1,000 results 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 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 Extract product data from Amazon search and category pages — price, rating, review count, ASIN, badges, and image — across marketplaces (US, UK, DE, CA, FR, IT, ES), using only public data, no login. ### What it does You pick a marketplace and give it search keywords or Amazon category URLs. It returns a clean list of the products on those result pages, one record per product, with the fields you see on the listing. It renders each page like a real browser over a residential proxy **in the marketplace's country**, so you get what a local shopper sees — with prices in the local currency. ### Use cases - **Price monitoring** — track prices and discounts on your own or competitors' products over time, in any supported market. - **FBA / product research** — pull ratings, review counts, and prices across a category to spot opportunities. - **Competitor analysis** — see who ranks for a keyword, at what price, with what rating. - **Product feeds** — feed listing data into dashboards, sheets, or your own tools. ### Supported marketplaces | Marketplace | Domain | Currency | |---|---|---| | US | amazon.com | USD | | UK | amazon.co.uk | GBP | | DE | amazon.de | EUR | | CA | amazon.ca | CAD | | FR | amazon.fr | EUR | | IT | amazon.it | EUR | | ES | amazon.es | EUR | Currency is set by the **marketplace**, not by the price symbol — amazon.ca shows a `$` sign but the currency is **CAD**. More marketplaces are planned. ### Inputs | Field | Type | Default | Required | Example | |---|---|---|---|---| | `marketplace` | select (US, UK, DE, CA, FR, IT, ES) | `US` | optional | `"DE"` | | `searchKeywords` | array of strings | `[]` | one of the two | `["wireless earbuds", "yoga mat"]` | | `categoryUrls` | array of URLs | `[]` | one of the two | `["https://www.amazon.de/s?k=coffee+grinder"]` | | `maxItems` | integer | `100` | optional | `500` | | `maxPagesPerQuery` | integer | `5` | optional | `10` | Provide at least one `searchKeywords` entry **or** one `categoryUrls` entry. Category URLs must be on the selected marketplace's domain (others are skipped). Amazon caps search at roughly 20 pages per query; `maxPagesPerQuery` also lets you stop earlier. ### Output One record per product. Here is a **real** record from a run (US, search: "wireless earbuds"): ```json { "asin": "B0H33STTGC", "title": "Wireless Earbuds, 2026 Bluetooth 5.4 Headphones Bass Stereo Ear Buds with Noise Cancelling Mic, LED Display in Ear Earphones 50H Playtime Ear Buds, IP7 Waterproof for Laptop Pad Phones Deep Black", "url": "https://www.amazon.com/dp/B0H33STTGC", "priceCurrent": 19.99, "priceOriginal": 129.99, "discountPct": 85, "currency": "USD", "rating": 4.8, "reviewCount": 871, "bsr": null, "isPrime": false, "isSponsored": false, "brand": null, "seller": null, "imageUrl": "https://m.media-amazon.com/images/I/61aSuH86kYL._AC_UY218_.jpg", "marketplace": "US", "scrapedAt": "2026-07-07T02:31:55.584Z" } ```` | Field | Description | |---|---| | `asin` | Amazon product ID. | | `title` | Product title as shown on the listing. | | `url` | Clean canonical product URL (`/dp/`), no tracking. | | `priceCurrent` | Current price shown, as a number (e.g. `19.99`). `null` if no price is shown. | | `priceOriginal` | List / "was" price when the item is discounted, else `null`. | | `discountPct` | Percent off, derived from current vs. original, else `null`. | | `currency` | Currency code, set by the marketplace: US→USD, UK→GBP, DE/FR/IT/ES→EUR, CA→CAD (not derived from the symbol). | | `rating` | Star rating, e.g. `4.8`. | | `reviewCount` | Number of ratings, e.g. `871`. | | `bsr` | Best Sellers Rank. Always `null` in this version — BSR is only shown on the product page, not in search results. Planned for a future version. | | `isPrime` | Whether the card shows a Prime badge (best-effort). | | `isSponsored` | Whether the result is a sponsored (ad) placement. | | `brand` | Brand line when shown on the card, else `null`. | | `seller` | `null` in this version — the seller is only shown on the product page, not in search results. | | `imageUrl` | Product thumbnail image URL. | | `marketplace` | The marketplace the record came from (`US`, `UK`, `DE`, `CA`, `FR`, `IT`, `ES`). | | `scrapedAt` | ISO timestamp of when the record was collected. | ### Cost This actor is billed **per product** (Pay Per Event). You pay for the products you get, not for time or attempts. As an example, at **$4 per 1,000 products**, scraping 1,000 products costs about **$4**. Scraping 100 products costs about **$0.40**. (See the actor's pricing on its Store page for the current rate.) ### Reliability & scheduling Amazon runs aggressive anti-bot protection. From time to time it serves an empty page instead of the real results — this affects every Amazon scraper, not just this one. To handle it, the actor **automatically retries with a fresh proxy session** when a page comes back without the product grid (or on a transient proxy connection blip), instead of silently returning nothing. For continuous monitoring, the recommended setup is to **schedule your runs** (Apify Schedules) — for example, once a day. Because Amazon's empty responses are intermittent, repeated scheduled runs give you reliable coverage over time. This is standard practice for Amazon data at scale: don't rely on a single attempt, let a schedule do the work. If a run returns fewer products than expected, that is the intermittent anti-bot behavior above — simply re-run it, or let your schedule pick it up on the next pass. ### Known limitations - **Page cap** — Amazon limits search to roughly 20 pages per query. You cannot page past that; `maxPagesPerQuery` respects it. - **BSR and seller** — not shown in search results, so they are `null` here. They live on the individual product page (planned for a future version). - **Marketplaces** — this version covers US, UK, DE, CA, FR, IT, ES. More are planned. - **Intermittent empty pages** — Amazon's anti-bot may serve empty pages; mitigated by automatic retry and by scheduling repeated runs (see above). - **Prime badge** — `isPrime` is best-effort and may under-report in this version. ### FAQ **Is this legal?** It collects only public data that any visitor can see, without logging in. You are responsible for how you use the data. **Do I need an Amazon account or API key?** No. No account, no login, no API key. **Which currency will prices be in?** The marketplace's currency (see the table above). The value is a plain number; the `currency` field tells you the code. **How many products can I get per search?** Up to several hundred, depending on the query and Amazon's per-search page cap. **Why do I sometimes get fewer products?** Amazon serves empty pages intermittently (anti-bot). Re-run the actor, or schedule it to run repeatedly for steady coverage. ### Changelog #### 1.1 - **Multi-marketplace.** Added UK, DE, CA, FR, IT, ES alongside US via a new `marketplace` input; each run uses that country's residential proxy and currency (US→USD, UK→GBP, DE/FR/IT/ES→EUR, CA→CAD). New `marketplace` field on every record. US behavior is unchanged. #### 1.0 - First release. Search keywords and category URLs, prices, ratings, review counts, images, and listing badges from Amazon US. Automatic retry with session rotation on empty pages. *** ### PT-BR (resumo) **O que faz:** extrai produtos de páginas de busca/categoria da Amazon — preço, avaliação, número de reviews, ASIN, imagem e badges — em 7 marketplaces (US, UK, DE, CA, FR, IT, ES), apenas com dados públicos, **sem login**. Renderiza cada página como um navegador real sobre proxy residencial **do país do marketplace**, com preço na moeda local. **Casos de uso:** monitoramento de preço, pesquisa de produto para FBA, análise de concorrentes, feeds de produto para dashboards. **Marketplaces:** US (amazon.com/USD), UK (amazon.co.uk/GBP), DE (amazon.de/EUR), CA (amazon.ca/**CAD**), FR (amazon.fr/EUR), IT (amazon.it/EUR), ES (amazon.es/EUR). A moeda vem do **marketplace**, não do símbolo — a amazon.ca mostra `$` mas é **CAD**. **Inputs:** `marketplace` (US/UK/DE/CA/FR/IT/ES, padrão US); `searchKeywords` (palavras de busca) e/ou `categoryUrls` (URLs no domínio do marketplace escolhido); `maxItems` (padrão 100); `maxPagesPerQuery` (padrão 5). Informe ao menos uma palavra de busca ou uma URL. **Saída:** um registro por produto (veja o exemplo em JSON acima) — `asin`, `title`, `url`, `priceCurrent`, `priceOriginal`, `discountPct`, `currency`, `rating`, `reviewCount`, `imageUrl`, `marketplace`, entre outros. `bsr` e `seller` ficam `null` nesta versão (só aparecem na página do produto — previstos para versão futura). Campos ausentes ficam `null`, nunca estimados. **Custo:** cobrado **por produto** (Pay Per Event). Exemplo: a **$4 por 1.000 produtos**, raspar 1.000 produtos custa cerca de **$4**. **Confiabilidade:** a Amazon tem anti-bot agressivo e às vezes serve páginas vazias (afeta todos os scrapers). O actor **retenta automaticamente com sessão nova** quando a página vem sem os produtos (ou num blip transiente de conexão do proxy). Para monitoramento contínuo, **agende runs** (Apify Schedules). Se um run trouxer menos produtos, reexecute ou deixe o agendamento resolver. **Limitações:** teto de ~20 páginas por busca; BSR e seller só na página de produto (versão futura); 7 marketplaces nesta versão; blocos intermitentes mitigados por retry/agendamento. # Actor input Schema ## `marketplace` (type: `string`): Which Amazon marketplace to scrape. Sets the domain, proxy country, and currency. ## `searchKeywords` (type: `array`): Free-text terms to search on the selected marketplace. Each term becomes one search, e.g. "wireless earbuds". ## `categoryUrls` (type: `array`): Amazon search or category URLs to scrape directly (must be on the selected marketplace's domain). URLs on other domains are skipped. ## `maxItems` (type: `integer`): Maximum number of products to collect across all queries. Pagination stops once reached. ## `maxPagesPerQuery` (type: `integer`): How many search pages to scrape per query. Amazon caps search around ~20 pages; the actor also stops early on an empty/clamped page. ## Actor input object example ```json { "marketplace": "US", "searchKeywords": [ "wireless earbuds" ], "categoryUrls": [], "maxItems": 100, "maxPagesPerQuery": 5 } ``` # 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 = { "searchKeywords": [ "wireless earbuds" ] }; // Run the Actor and wait for it to finish const run = await client.actor("johnatan029/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 = { "searchKeywords": ["wireless earbuds"] } # Run the Actor and wait for it to finish run = client.actor("johnatan029/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 '{ "searchKeywords": [ "wireless earbuds" ] }' | apify call johnatan029/amazon-product-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=johnatan029/amazon-product-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Amazon Product Scraper: Prices, BSR, Ratings & Seller Data", "description": "Scrapes Amazon search/category results across 7 marketplaces (US, UK, DE, CA, FR, IT, ES): price, rating, review count, images and listing data. Public data, no login.", "version": "1.1", "x-build-id": "GZM4pCm8fOHjYrsrh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/johnatan029~amazon-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-johnatan029-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/johnatan029~amazon-product-scraper/runs": { "post": { "operationId": "runs-sync-johnatan029-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/johnatan029~amazon-product-scraper/run-sync": { "post": { "operationId": "run-sync-johnatan029-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": { "marketplace": { "title": "Marketplace", "enum": [ "US", "UK", "DE", "CA", "FR", "IT", "ES" ], "type": "string", "description": "Which Amazon marketplace to scrape. Sets the domain, proxy country, and currency.", "default": "US" }, "searchKeywords": { "title": "Search keywords", "type": "array", "description": "Free-text terms to search on the selected marketplace. Each term becomes one search, e.g. \"wireless earbuds\".", "default": [], "items": { "type": "string" } }, "categoryUrls": { "title": "Category / search URLs", "type": "array", "description": "Amazon search or category URLs to scrape directly (must be on the selected marketplace's domain). URLs on other domains are skipped.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of products to collect across all queries. Pagination stops once reached.", "default": 100 }, "maxPagesPerQuery": { "title": "Max pages per query", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many search pages to scrape per query. Amazon caps search around ~20 pages; the actor also stops early on an empty/clamped page.", "default": 5 } } }, "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 } } } } } } } } } } ```