# Amazon Product Scraper Search & Sales Estimator (`doorma_10/amazon-product-scraper-search-sales-estimator`) Actor

Fast, 512MB RAM Amazon scraper for products, search keywords, ASINs, categories & bestsellers across global domains (.com, .de, .es, etc.). Extracts 50+ fields, BSR, monthly sales & revenue estimates, buybox offers, variants, and postal code geo-targeting.

- **URL**: https://apify.com/doorma_10/amazon-product-scraper-search-sales-estimator.md
- **Developed by:** [Doorman Data Labs](https://apify.com/doorma_10) (community)
- **Categories:** E-commerce
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.80 / 1,000 product scrapeds

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Amazon Product, Search, Bestsellers & Sales Intelligence Scraper

Production-grade, high-speed, 512MB RAM Apify Actor built with TypeScript, `@crawlee/cheerio`, and `got-scraping` for scraping Amazon products, search results, category pages, Bestseller rankings, and estimated sales across all global Amazon domains (`.com`, `.es`, `.de`, `.co.uk`, `.com.mx`, `.ca`, `.fr`, `.it`, `.co.jp`, etc.).

***

### 💰 Pricing & Transparent Billing

⚡ **Launch Special (Limited Time): $2.80 per 1,000 products** ($0.0028 / product) + $0.028 start fee.

- **Example:** 1,000 complete products cost only **$2.80**.
- **✨ Free Delivery ZIP Code & Geolocation Included:** While competing actors charge an extra **+$60.00 / 1k results** just for ZIP code changes, our localized pricing and ZIP code switching is **100% free and included**.
- **✨ Free Sales Intelligence Included:** Estimated monthly sales and revenue calculations derived from BSR rankings are included at no extra cost.
- **Pay only for success:** Products that could not be scraped are never charged.
- **Free Monthly Allowance:** Every Apify account receives **$5.00 in free usage every month**, enough for up to **~1,700 complete products completely free**.

***

### ⚡ Key Highlights & Features

- **Multiple Input Modes:** Provide search keywords (`keywords`), ASIN lists (`asins`), or URLs (`startUrls`).
- **Global Marketplaces:** Target any Amazon domain (`com`, `de`, `es`, `co.uk`, `com.mx`, `fr`, `it`, `ca`, `co.jp`, etc.) with automatic proxy country matching.
- **Sales Intelligence & Revenue Estimates:** Automatically derives `bought_in_past_month`, `estimated_monthly_sales` (e.g. 2,872 units), and `estimated_monthly_revenue` (e.g. `$20,075.28`) from purchase volume and category Best Sellers Ranks (BSR).
- **50+ Complete Fields & Zero Null Leakage:** Full extraction for Best Sellers Rank, Breadcrumbs & Categories, A+ Content (including 3rd-party vendor A+ content), Brand Story, Product Comparison Tables, AI Reviews Summaries, Answered Questions, Coupons, and Discounts.
- **Delivery Zip Code & Geolocation:** Injects localization cookies (`ubid-main`, `session-id`, `i18n-prefs`, `lc-main`, `sp-cdn`) and invokes the Amazon address change endpoint (`/gp/delivery/ajax/address-change.html`) so local pricing, stock, and delivery dates match target `zipCode` and `countryCode`.
- **Anti-Captcha Resilience & Session Pool:** Automatic detection of Amazon Robot Check (`/errors/validateCaptcha`). Automatically retires burned sessions and retries with a fresh residential proxy IP.
- **High Speed & Low Memory (256MB–512MB RAM):** Powered by `@crawlee/cheerio` with lightweight memory usage and sub-2-second page response times.

***

### 📥 Input Modes & Examples

#### 1. Keywords Search across any marketplace

```json
{
  "keywords": ["garlic press", "yoga mat"],
  "maxResultsPerKeyword": 100,
  "marketplace": "com"
}
```

#### 2. List of ASINs on a specific marketplace (e.g. Germany)

```json
{
  "asins": ["B08J7PQGD7", "B0BR3L78XN"],
  "marketplace": "de"
}
```

#### 3. Direct Product or Category Links

```json
{
  "startUrls": [
    {"url": "https://www.amazon.com/dp/B00HEZ888K"},
    {"url": "https://www.amazon.com/dp/B0BZYCJK89"}
  ]
}
```

#### 4. Advanced: Zip Code Targeting, Offers & Variants

```json
{
  "asins": ["B09X7MPX8L"],
  "maxOffers": 20,
  "maxVariantsPerProduct": 10,
  "zipCode": "90210"
}
```

***

### 🌎 Amazon Marketplaces & Regional Filtering Note

Amazon does not operate a domestic fulfillment marketplace in Argentina (`amazon.com.ar`). When configuring `countryCode: "AR"`, Amazon filters the catalog down to only the few items eligible for Amazon Global International Shipping to Argentina.

To scrape the complete catalog, use `marketplace: "com"` with US delivery (`countryCode: "US"`, `zipCode: "10001"`), or target local Latin American / European Amazon stores such as `marketplace: "com.mx"` (Mexico), `marketplace: "com.br"` (Brazil), or `marketplace: "es"` (Spain).

***

### 📤 Output Formats

The scraper provides 100% dual compatibility: friendly flat fields for immediate table exports, plus the full canonical schema for rich programmatic pipelines.

#### Single Product Row Example:

```json
{
  "asin": "B0DJ28XG7Z",
  "url": "https://www.amazon.com/dp/B0DJ28XG7Z",
  "title": "Kitchen Garlic Press, Rust Proof & Dishwasher Safe Garlic Mincer, Durable Garlic Crusher Set with Peeler & Brush",
  "brand": "SRISE",
  "price": {
    "value": 6.99,
    "currency": "USD"
  },
  "list_price": "$7.99",
  "discount_percent": 13,
  "coupon": "Apply $1.00 coupon",
  "rating": 4.6,
  "review_count": 1477,
  "review_distribution": {
    "5_star_pct": 78,
    "4_star_pct": 11,
    "3_star_pct": 5,
    "2_star_pct": 2,
    "1_star_pct": 4
  },
  "best_sellers_rank": [
    { "rank": 1056, "category": "Kitchen & Dining" },
    { "rank": 5, "category": "Garlic Presses" }
  ],
  "bought_in_past_month": "3K+ bought in past month",
  "estimated_monthly_sales": 3000,
  "estimated_monthly_revenue": "$20,970.00",
  "categories": [
    "Home & Kitchen",
    "Kitchen & Dining",
    "Kitchen Utensils & Gadgets",
    "Seasoning & Spice Tools",
    "Garlic Tools",
    "Garlic Presses"
  ],
  "features": [
    "GARLIC PRESS SET: Ergonomic and streamlined design...",
    "EASY TO CLEAN: Dishwasher safe rust-proof zinc alloy..."
  ],
  "description": "High performance kitchen mincer crusher...",
  "specs": {
    "Brand Name": "SRISE",
    "Model Number": "JG-GP-01",
    "Material Type": "Zinc Alloy",
    "Item Weight": "0.25 kg"
  },
  "variants": [
    { "asin": "B0DJ2BL89S", "name": "Copper", "dimensions": ["Copper"] },
    { "asin": "B0DJ28S4WT", "name": "Black", "dimensions": ["Black"] }
  ],
  "images": [
    "https://m.media-amazon.com/images/I/71example.jpg"
  ],
  "availability": "In Stock",
  "stock_left": null,
  "sold_by": "SRISE",
  "ships_from": "Amazon",
  "is_prime": true,
  "is_fba": true,
  "badges": ["Amazon's Choice", "#1 Best Seller"],
  "related_asins": ["B07EXAMPLE1", "B08EXAMPLE2"],
  "search_keyword": "garlic press",
  "search_position": 3,
  "sponsored": false,
  "scraped_at": "2026-11-11T12:00:00.000Z",
  "parent_asin": "B0GRW417Q5",
  "delivery_location": "90210",
  "offers": [
    {
      "url": "https://www.amazon.com/dp/B0DJ28XG7Z",
      "condition": "New",
      "price": { "value": 6.99, "currency": "USD" },
      "seller": { "name": "SRISE" },
      "position": 1,
      "isPinnedOffer": true
    }
  ]
}
```

***

### 🛠️ Development & Testing

```bash
## Compile TypeScript to dist/
npm run build

## Run unit and edge-case test suites (38 automated tests)
npm test

## Run the actor locally
npm start
```

# Actor input Schema

## `keywords` (type: `array`):

List of keywords to search on Amazon (e.g., \["garlic press", "yoga mat"]).

## `asins` (type: `array`):

List of Amazon Standard Identification Numbers (ASINs) to scrape directly (e.g., \["B08J7PQGD7", "B0BR3L78XN"]).

## `marketplace` (type: `string`):

Amazon marketplace domain TLD to scrape (e.g. com, de, es, co.uk, fr, it, ca, com.mx, co.jp). Default is com.

## `maxResultsPerKeyword` (type: `integer`):

Maximum number of products to scrape per search keyword.

## `startUrls` (type: `array`):

Amazon URLs to scrape. Supports product pages (/dp/ASIN), search result pages (/s?k=...), category pages (/b?node=...), and Best Sellers pages (/gp/bestsellers/...).

## `maxItemsPerStartUrl` (type: `integer`):

Maximum number of products to scrape per search or category start URL.

## `maxSearchPagesPerStartUrl` (type: `integer`):

Maximum number of pagination pages to traverse for each search or category start URL.

## `scrapeProductDetails` (type: `boolean`):

If enabled, visits each product page to extract all 50+ canonical fields (specifications, variants, reviews, A+ content, images). If disabled, outputs lightweight search/category listings directly.

## `language` (type: `string`):

Language preference cookie for Amazon navigation (e.g. en_US, es_ES, de_DE, fr_FR, etc.).

## `countryCode` (type: `string`):

Two-letter country code for Amazon delivery address simulation (e.g., US, ES, DE, GB, MX, CA, FR, IT).

## `zipCode` (type: `string`):

Destination postal code / zip code (e.g., 10001 for New York, 28001 for Madrid, 10115 for Berlin). Used to get local price, inventory, and delivery dates.

## `locationDeliverableRoutes` (type: `array`):

Route types where the delivery location (zipCode and countryCode) should be configured.

## `proxyCountry` (type: `string`):

Select proxy country to match Amazon marketplace domain and avoid anti-scraping blocks.

## `useCaptchaSolver` (type: `boolean`):

If enabled, detects Amazon captcha verification challenges on amazon.com, extracts the captcha image, and solves the token automatically. If disabled or failed, rotates IP session.

## `proxyConfiguration` (type: `object`):

Apify Proxy configuration. Residential proxies matched with proxyCountry are strongly recommended for Amazon.

## `maxOffers` (type: `integer`):

Number of alternative offers/sellers to extract from /gp/offer-listing/ASIN. Set to 0 to disable.

## `scrapeSellers` (type: `boolean`):

Whether to extract seller ID, seller name, and seller store URL.

## `scrapeProductVariantPrices` (type: `boolean`):

Extract prices for all product variants found in Twister data.

## `maxVariantsPerProduct` (type: `integer`):

Maximum number of product variant ASINs to scrape as separate rows. Set to 0 to only scrape parent ASIN.

## `maxProductVariantsAsSeparateResults` (type: `integer`):

Alias for maxVariantsPerProduct. Maximum number of product variant ASINs to enqueue as standalone product outputs. 0 disables variant crawling.

## Actor input object example

```json
{
  "marketplace": "com",
  "maxResultsPerKeyword": 100,
  "startUrls": [
    {
      "url": "https://www.amazon.com/dp/B0D1XD1ZV3"
    }
  ],
  "maxItemsPerStartUrl": 100,
  "maxSearchPagesPerStartUrl": 9999,
  "scrapeProductDetails": true,
  "language": "en_US",
  "countryCode": "US",
  "zipCode": "10001",
  "locationDeliverableRoutes": [
    "PRODUCT",
    "SEARCH",
    "OFFERS"
  ],
  "proxyCountry": "AUTO_SELECT_PROXY_COUNTRY",
  "useCaptchaSolver": false,
  "proxyConfiguration": {
    "useApifyProxy": true
  },
  "maxOffers": 5,
  "scrapeSellers": true,
  "scrapeProductVariantPrices": false,
  "maxVariantsPerProduct": 0,
  "maxProductVariantsAsSeparateResults": 0
}
```

# Actor output Schema

## `results` (type: `string`):

Scraped Amazon products with pricing, BSR, monthly sales and revenue estimates.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "startUrls": [
        {
            "url": "https://www.amazon.com/dp/B0D1XD1ZV3"
        }
    ],
    "countryCode": "US",
    "zipCode": "10001"
};

// Run the Actor and wait for it to finish
const run = await client.actor("doorma_10/amazon-product-scraper-search-sales-estimator").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "startUrls": [{ "url": "https://www.amazon.com/dp/B0D1XD1ZV3" }],
    "countryCode": "US",
    "zipCode": "10001",
}

# Run the Actor and wait for it to finish
run = client.actor("doorma_10/amazon-product-scraper-search-sales-estimator").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "startUrls": [
    {
      "url": "https://www.amazon.com/dp/B0D1XD1ZV3"
    }
  ],
  "countryCode": "US",
  "zipCode": "10001"
}' |
apify call doorma_10/amazon-product-scraper-search-sales-estimator --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,doorma_10/amazon-product-scraper-search-sales-estimator"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/EjUHhwochn91kZcTv/builds/g3vuN0olYsxwlo3Rn/openapi.json
