# Amazon Real-Time Data — Search, Reviews, Deals & Best Sellers (`b2b_leads/amazon-real-time-data-search-reviews-deals-best-sellers`) Actor Scrape live Amazon data: product search, details, seller offers, reviews, deals & best sellers across 25 marketplaces. Enable only what you need via checkboxes. Built-in CAPTCHA handling, residential proxy support, and structured JSON for research, repricing, and integrations. - **URL**: https://apify.com/b2b\_leads/amazon-real-time-data-search-reviews-deals-best-sellers.md - **Developed by:** [Chidubem Aneke](https://apify.com/b2b_leads) (community) - **Categories:** E-commerce, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.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 Real-Time Data — Live Amazon Product Scraper **Stop fighting Amazon’s anti-bot walls.** This Actor delivers **live product search, prices, offers, reviews, deals, and best sellers** as clean JSON — across **25 marketplaces**, with **built-in CAPTCHA handling** and **residential proxy** support. No coding. No 2Captcha account. No scraper maintenance. Turn on only the features you need, pick your country, click **Start**, and export or pipe results to Slack, Sheets, Zapier, or your own API. --- ### Why teams choose this Actor - **Real-time data** — prices, stock signals, reviews, and rankings scraped fresh each run - **Seven tools in one** — search, PDP details, seller offers, reviews, URL scraper, best sellers, deals - **Checkbox UX** — enable only what you need; Product Search is on by default - **25 Amazon stores** — US, UK, DE, FR, JP, IN, AE, and more from a single country dropdown - **CAPTCHA-ready** — robot checks handled internally; you never configure API keys - **Structured JSON** — every row tagged with `featureType` for easy filtering and integrations - **Apify-native** — schedule runs, webhooks, API access, CSV/Excel export out of the box --- ### Who is this for? | You are… | You get… | |----------|----------| | **Amazon seller or brand** | Competitor prices, offer counts, buy-box intelligence | | **Market researcher** | Category best sellers, search SERPs, review datasets | | **Deal hunter or affiliate** | Fresh deal feeds with discounts, badges, and ASINs | | **Agency or consultant** | Client-ready datasets without building scrapers | | **Dropshipper or reseller** | Live ASIN lookup and pricing before you list | | **Developer** | Clean JSON via Apify API — a practical **Amazon data API alternative** without SP-API onboarding | --- ### What you get every run Structured records in your Apify dataset, ready to export or integrate: | Field | Meaning | |-------|---------| | `featureType` | Which feature produced the row | | `country` | Marketplace (US, UK, DE, …) | | `url` | Source page | | `scrapedAt` | ISO timestamp | | **Plus** | ASIN, title, price, currency, rating, reviews, seller, rank, deal badge, review text, images, and more | Filter by `featureType`, download CSV, or hit the dataset API — same workflow for every feature. --- ### Seven features — use one or all #### 🔍 Product Search *(on by default)* Keyword search with ASIN, title, price, rating, review count, Prime flag, and SERP position. Paginate until you hit your target count. *Example:* `"wireless mouse"` → 50 results on Amazon US, sorted by price. --- #### 📦 Product Details Full product page data for any ASIN or URL: brand, seller, stock, bullets, description, images, ratings. *Example:* ASIN `B004YAVF8I` → live price, specs, and 40k+ review count in one row. --- #### 💰 Product Offers **Every seller offer** for as many ASINs as you need — price, condition, seller, shipping, Prime/FBA flags. Batch hundreds of ASINs in one run for repricing and buy-box analysis. --- #### ⭐ Product Reviews Paginated reviews with title, body, stars, author, date, verified purchase, and helpful votes. *Example:* 100 recent reviews across 10 ASINs for VOC or sentiment pipelines. --- #### 🔗 Scrape By URL Paste any Amazon link — product, search, deals, best sellers — and get structured data with automatic page-type detection. --- #### 🏆 Best Sellers Ranked products by category slug or URL: rank, ASIN, title, price, rating. *Example:* Top 50 in **Software** or **Electronics** on Amazon US. --- #### 🏷️ Deals Today's Deals / Gold Box with price, was-price, discount %, badge, and image. Paginate with offset for larger deal feeds. --- ### 25 Amazon marketplaces Set **Marketplace country** once — domain, currency, and language follow for all enabled features: **US** · **CA** · **MX** · **BR** · **UK** · **DE** · **FR** · **IT** · **ES** · **NL** · **BE** · **SE** · **PL** · **TR** · **IE** · **AE** · **SA** · **EG** · **IN** · **SG** · **AU** · **JP** · **AT** · **CH** · **LU** --- ### How to run 1. Click **Start** on this Actor page. 2. Choose your **marketplace country** (default: US). 3. **Check the features** you need — uncheck Product Search if you only want details, reviews, or deals. 4. Fill in keywords, ASINs, URLs, or category for the features you enabled. 5. Keep **Proxy → Residential** (recommended). 6. Run — download results or connect a **webhook** / **schedule**. **Pro tip:** Schedule daily runs for price tracking, deal digests, or best-seller rank changes. --- ### Example inputs (API, MCP, and automation) Use these JSON payloads with the **Apify API**, **Apify MCP** (`call-actor`), or scheduled runs. In the Console, the same options map to the checkboxes and fields above. **Important:** Product Search is **on by default**. When running a single feature via API or MCP, set `"enableProductSearch": false` and enable only the feature you need. #### Product Search only ```json { "country": "US", "enableProductSearch": true, "searchKeywords": ["wireless mouse"], "searchMaxResultsPerKeyword": 10 } ```` #### Product Details only ```json { "country": "US", "enableProductSearch": false, "enableProductDetails": true, "productAsins": ["B004YAVF8I"] } ``` #### Product Offers only ```json { "country": "US", "enableProductSearch": false, "enableProductOffers": true, "offersAsins": ["B004YAVF8I", "B0D1XD1ZV3"] } ``` #### Product Reviews only ```json { "country": "US", "enableProductSearch": false, "enableProductReviews": true, "reviewsAsins": ["B004YAVF8I"], "reviewsMaxPerProduct": 20, "reviewsSortBy": "recent" } ``` #### Scrape By URL only ```json { "country": "US", "enableProductSearch": false, "enableScrapeByUrl": true, "scrapeUrls": ["https://www.amazon.com/dp/B004YAVF8I"] } ``` #### Best Sellers only ```json { "country": "US", "enableProductSearch": false, "enableBestSellers": true, "bestSellersCategory": "software", "bestSellerMaxProducts": 25 } ``` #### Deals only ```json { "country": "US", "enableProductSearch": false, "enableDeals": true, "dealsMaxProducts": 30, "dealsOffset": 0 } ``` #### Multiple features in one run ```json { "country": "US", "enableProductSearch": false, "enableProductDetails": true, "enableProductOffers": true, "productAsins": ["B004YAVF8I"], "offersAsins": ["B004YAVF8I"] } ``` Filter output rows by `featureType` (`product_search`, `product_details`, `product_offers`, etc.). Dataset views: `overview`, `search`, `details`, `offers`, `reviews`, `deals`, `bestSellers`. *** ### Example workflows **Competitor repricing** — Product Offers + Product Details on your ASIN list → daily schedule → webhook when price or offer count shifts. **Launch research** — Product Search + Product Reviews on a keyword → CSV export for positioning and review themes. **Morning deal feed** — Deals with 50–100 items → Google Sheets or email via Zapier every morning. **Category report** — Best Sellers on `electronics` or `software` → weekly rank snapshot for trend decks. *** ### Integrations Works with the full Apify ecosystem: - **Webhooks** on run success - **REST API** for dataset items - **Slack**, **Google Sheets**, **Zapier**, **Make**, **Airbyte**, custom ETL - **Scheduled runs** for hands-off **price monitoring** and deal alerts *** ### This Actor vs alternatives | Approach | Problem | This Actor | |----------|---------|------------| | Copy-paste | Slow, doesn't scale | Automated, repeatable | | DIY scripts | Break on HTML changes; CAPTCHA pain | Maintained parsers + built-in CAPTCHA recovery | | Amazon SP-API | Approval, limited public data | Broad coverage of public pages | | Generic scrapers | No Amazon-specific fields | Purpose-built for SERP, PDP, deals, reviews | You pay for the scrape you need — enable only the checkboxes that matter. *** ### FAQ **Do I need to write code?**\ No. Configure inputs, run, export. Developers can use the Apify API for full automation. **Which proxy should I use?**\ **Apify Proxy → Residential**, country matched to your marketplace. This is the default and works best on Amazon. **Can I run multiple features in one run?**\ Yes. Enable any combination — each record is tagged with `featureType` so you can split results downstream. **How is this different from Amazon SP-API?**\ SP-API is for registered sellers and official catalog APIs. This Actor scrapes **public Amazon pages** — search, reviews, deals, best sellers — ideal for **market research** and **competitor intelligence** without seller approval. **What happens when Amazon shows a CAPTCHA?**\ The Actor handles common robot checks **internally** (including image CAPTCHAs and reCAPTCHA). You do **not** need a 2Captcha account or API key — just use residential proxy and run. **What about rate limits and blocks?**\ Amazon is aggressive on bots. Use residential proxy, sensible batch sizes, and retry failed runs. The Actor rotates sessions and retries transient errors automatically. **How many ASINs can I scrape for offers?**\ **As many as you need.** Add ASINs to the offers list and run — there is no artificial cap. For very large batches, increase memory or split across scheduled runs. **How many reviews or search results can I get?**\ Set your amount per feature (e.g. max results per keyword, max reviews per product). The Actor paginates until the limit is reached or Amazon has no more pages. **Does Product Search run by default?**\ Yes. Uncheck it if you only want details, offers, reviews, deals, or URL scraping. **Can I scrape by product URL?**\ Yes — enable **Scrape By URL** or **Product Details** and paste the full Amazon link. **What memory and timeout should I use?**\ **2048 MB** and **900 s** (defaults) work for most runs. Increase memory for large multi-feature or high-volume batches. *** ### Get started now 1. Click **Try for free** or **Start**. 2. Pick your marketplace and features. 3. Use **Residential proxy**. 4. Run — then **schedule** or **integrate**. **Live Amazon data. Structured JSON. Zero maintenance.** # Actor input Schema ## `country` (type: `string`): Amazon marketplace to scrape. Drives domain, currency, and language headers. ## `enableProductSearch` (type: `boolean`): Search Amazon by keyword and return matching products from search results. ## `searchKeywords` (type: `array`): One or more keywords to search (1–20). Required when Product Search is enabled. ## `searchMaxResultsPerKeyword` (type: `integer`): Maximum products to return per keyword (1–100). ## `searchPage` (type: `integer`): First search results page to scrape (1-based). ## `searchMaxPages` (type: `integer`): Number of search result pages to crawl per keyword. ## `searchSort` (type: `string`): How to sort search results on Amazon. ## `searchCategory` (type: `string`): Restrict search to an Amazon category using its browse node ID. ## `enableProductDetails` (type: `boolean`): Fetch full product page data for specific ASINs or URLs. ## `productAsins` (type: `array`): 10-character Amazon ASINs to scrape. ## `productUrls` (type: `array`): Alternative to ASINs — paste full Amazon product page URLs. ## `includeVariants` (type: `boolean`): Parse product variation swatches when available. ## `includeDescription` (type: `boolean`): Include product description text in output. ## `includeImages` (type: `boolean`): Include product image URLs in output. ## `enableProductOffers` (type: `boolean`): Fetch all seller offers for given ASINs (Phase 3). ## `offersAsins` (type: `array`): ASINs to fetch offers for. ## `offersCondition` (type: `string`): Filter offers by item condition. Use All to return every available offer. ## `enableProductReviews` (type: `boolean`): Scrape customer reviews for given ASINs (Phase 3). ## `reviewsAsins` (type: `array`): ASINs to fetch reviews for. ## `reviewsMaxPerProduct` (type: `integer`): Maximum number of reviews to collect per ASIN (1–100). ## `reviewsSortBy` (type: `string`): How to sort reviews on the product page. ## `reviewsFilterByStar` (type: `integer`): Filter reviews by star rating. 0 = all ratings, 1–5 = specific star count. ## `enableScrapeByUrl` (type: `boolean`): Scrape arbitrary Amazon URLs with auto page-type detection (Phase 4). ## `scrapeUrls` (type: `array`): Amazon URLs to scrape. ## `enableBestSellers` (type: `boolean`): Scrape Amazon best seller category pages (Phase 4). ## `bestSellerCategoryUrls` (type: `array`): URLs of Amazon best seller category pages. ## `bestSellersCategory` (type: `string`): Category path slug (e.g. software, electronics, books). Used when category URLs are empty. ## `bestSellerCategoryIds` (type: `array`): Amazon browse node IDs for best seller categories. ## `bestSellerMaxProducts` (type: `integer`): Maximum number of best seller products to return per category (1–100). ## `enableDeals` (type: `boolean`): Scrape Amazon deals / Gold Box pages (Phase 4). ## `dealsMaxProducts` (type: `integer`): Maximum number of deals to return from Amazon Gold Box (1–100). ## `dealsOffset` (type: `integer`): Pagination offset for Today's Deals (multiples of 30). 0 = first page. ## `dealsMinDiscountPercent` (type: `number`): Only include deals with at least this discount percentage. ## `proxyConfiguration` (type: `object`): Use Apify Proxy with US Residential for best results on Amazon. Leave the default unless you know you need something else. ## Actor input object example ```json { "country": "US", "enableProductSearch": true, "searchKeywords": [ "wireless mouse" ], "searchMaxResultsPerKeyword": 10, "searchPage": 1, "searchMaxPages": 1, "searchSort": "relevance", "searchCategory": "", "enableProductDetails": false, "productAsins": [], "productUrls": [], "includeVariants": false, "includeDescription": true, "includeImages": true, "enableProductOffers": false, "offersAsins": [], "offersCondition": "all", "enableProductReviews": false, "reviewsAsins": [], "reviewsMaxPerProduct": 10, "reviewsSortBy": "recent", "reviewsFilterByStar": 0, "enableScrapeByUrl": false, "scrapeUrls": [], "enableBestSellers": false, "bestSellerCategoryUrls": [], "bestSellersCategory": "software", "bestSellerCategoryIds": [], "bestSellerMaxProducts": 50, "enableDeals": false, "dealsMaxProducts": 50, "dealsOffset": 0, "dealsMinDiscountPercent": 0, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } ``` # Actor output Schema ## `allResults` (type: `string`): Complete dataset with every field from all enabled features in this run. ## `overview` (type: `string`): Compact table — feature type, ASIN, title, price, rating, reviews, and source URL. ## `search` (type: `string`): Search result rows only (featureType = product\_search). ## `details` (type: `string`): Product detail page rows (featureType = product\_details). ## `offers` (type: `string`): Seller offer rows (featureType = product\_offers). ## `reviews` (type: `string`): Customer review rows (featureType = product\_reviews). ## `deals` (type: `string`): Today's Deals rows (featureType = deals). ## `bestSellers` (type: `string`): Best seller ranking rows (featureType = best\_sellers). # 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 mouse" ] }; // Run the Actor and wait for it to finish const run = await client.actor("b2b_leads/amazon-real-time-data-search-reviews-deals-best-sellers").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 mouse"] } # Run the Actor and wait for it to finish run = client.actor("b2b_leads/amazon-real-time-data-search-reviews-deals-best-sellers").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 mouse" ] }' | apify call b2b_leads/amazon-real-time-data-search-reviews-deals-best-sellers --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=b2b_leads/amazon-real-time-data-search-reviews-deals-best-sellers", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Amazon Real-Time Data — Search, Reviews, Deals & Best Sellers", "description": "Scrape live Amazon data: product search, details, seller offers, reviews, deals & best sellers across 25 marketplaces. Enable only what you need via checkboxes. Built-in CAPTCHA handling, residential proxy support, and structured JSON for research, repricing, and integrations.", "version": "0.0", "x-build-id": "yEZiela1Z3G7Rkzvl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/b2b_leads~amazon-real-time-data-search-reviews-deals-best-sellers/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-b2b_leads-amazon-real-time-data-search-reviews-deals-best-sellers", "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/b2b_leads~amazon-real-time-data-search-reviews-deals-best-sellers/runs": { "post": { "operationId": "runs-sync-b2b_leads-amazon-real-time-data-search-reviews-deals-best-sellers", "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/b2b_leads~amazon-real-time-data-search-reviews-deals-best-sellers/run-sync": { "post": { "operationId": "run-sync-b2b_leads-amazon-real-time-data-search-reviews-deals-best-sellers", "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": { "country": { "title": "Marketplace country", "enum": [ "US", "CA", "MX", "BR", "UK", "DE", "FR", "IT", "ES", "NL", "BE", "SE", "PL", "TR", "IE", "AE", "SA", "EG", "IN", "SG", "AU", "JP", "AT", "CH", "LU" ], "type": "string", "description": "Amazon marketplace to scrape. Drives domain, currency, and language headers.", "default": "US" }, "enableProductSearch": { "title": "Product Search", "type": "boolean", "description": "Search Amazon by keyword and return matching products from search results.", "default": true }, "searchKeywords": { "title": "Search keywords", "type": "array", "description": "One or more keywords to search (1–20). Required when Product Search is enabled.", "default": [ "wireless mouse" ], "items": { "type": "string" } }, "searchMaxResultsPerKeyword": { "title": "Max results per keyword", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum products to return per keyword (1–100).", "default": 10 }, "searchPage": { "title": "Start page", "minimum": 1, "maximum": 20, "type": "integer", "description": "First search results page to scrape (1-based).", "default": 1 }, "searchMaxPages": { "title": "Max pages per keyword", "minimum": 1, "maximum": 10, "type": "integer", "description": "Number of search result pages to crawl per keyword.", "default": 1 }, "searchSort": { "title": "Sort order", "enum": [ "relevance", "price-asc", "price-desc", "review-rank", "date-desc" ], "type": "string", "description": "How to sort search results on Amazon.", "default": "relevance" }, "searchCategory": { "title": "Category browse node ID (optional)", "type": "string", "description": "Restrict search to an Amazon category using its browse node ID.", "default": "" }, "enableProductDetails": { "title": "Product Details", "type": "boolean", "description": "Fetch full product page data for specific ASINs or URLs.", "default": false }, "productAsins": { "title": "Product ASINs", "type": "array", "description": "10-character Amazon ASINs to scrape.", "default": [], "items": { "type": "string" } }, "productUrls": { "title": "Product URLs", "type": "array", "description": "Alternative to ASINs — paste full Amazon product page URLs.", "default": [], "items": { "type": "string" } }, "includeVariants": { "title": "Include variants", "type": "boolean", "description": "Parse product variation swatches when available.", "default": false }, "includeDescription": { "title": "Include description", "type": "boolean", "description": "Include product description text in output.", "default": true }, "includeImages": { "title": "Include images", "type": "boolean", "description": "Include product image URLs in output.", "default": true }, "enableProductOffers": { "title": "Product Offers", "type": "boolean", "description": "Fetch all seller offers for given ASINs (Phase 3).", "default": false }, "offersAsins": { "title": "Offer ASINs", "type": "array", "description": "ASINs to fetch offers for.", "default": [], "items": { "type": "string" } }, "offersCondition": { "title": "Offer condition filter", "enum": [ "all", "new", "used", "refurbished" ], "type": "string", "description": "Filter offers by item condition. Use All to return every available offer.", "default": "all" }, "enableProductReviews": { "title": "Product Reviews", "type": "boolean", "description": "Scrape customer reviews for given ASINs (Phase 3).", "default": false }, "reviewsAsins": { "title": "Review ASINs", "type": "array", "description": "ASINs to fetch reviews for.", "default": [], "items": { "type": "string" } }, "reviewsMaxPerProduct": { "title": "Max reviews per product", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of reviews to collect per ASIN (1–100).", "default": 10 }, "reviewsSortBy": { "title": "Review sort", "enum": [ "recent", "helpful" ], "type": "string", "description": "How to sort reviews on the product page.", "default": "recent" }, "reviewsFilterByStar": { "title": "Star rating filter", "minimum": 0, "maximum": 5, "type": "integer", "description": "Filter reviews by star rating. 0 = all ratings, 1–5 = specific star count.", "default": 0 }, "enableScrapeByUrl": { "title": "Scrape By URL", "type": "boolean", "description": "Scrape arbitrary Amazon URLs with auto page-type detection (Phase 4).", "default": false }, "scrapeUrls": { "title": "Amazon URLs", "type": "array", "description": "Amazon URLs to scrape.", "default": [], "items": { "type": "string" } }, "enableBestSellers": { "title": "Best Sellers", "type": "boolean", "description": "Scrape Amazon best seller category pages (Phase 4).", "default": false }, "bestSellerCategoryUrls": { "title": "Best seller category URLs", "type": "array", "description": "URLs of Amazon best seller category pages.", "default": [], "items": { "type": "string" } }, "bestSellersCategory": { "title": "Best seller category slug", "type": "string", "description": "Category path slug (e.g. software, electronics, books). Used when category URLs are empty.", "default": "software" }, "bestSellerCategoryIds": { "title": "Best seller browse node IDs", "type": "array", "description": "Amazon browse node IDs for best seller categories.", "default": [], "items": { "type": "string" } }, "bestSellerMaxProducts": { "title": "Max best seller products", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of best seller products to return per category (1–100).", "default": 50 }, "enableDeals": { "title": "Deals", "type": "boolean", "description": "Scrape Amazon deals / Gold Box pages (Phase 4).", "default": false }, "dealsMaxProducts": { "title": "Max deals", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of deals to return from Amazon Gold Box (1–100).", "default": 50 }, "dealsOffset": { "title": "Deals page offset", "minimum": 0, "type": "integer", "description": "Pagination offset for Today's Deals (multiples of 30). 0 = first page.", "default": 0 }, "dealsMinDiscountPercent": { "title": "Minimum discount (%)", "minimum": 0, "type": "number", "description": "Only include deals with at least this discount percentage.", "default": 0 }, "proxyConfiguration": { "title": "Proxy settings", "type": "object", "description": "Use Apify Proxy with US Residential for best results on Amazon. Leave the default unless you know you need something else.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "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 } } } } } } } } } } ```