# Amazon Product Scraper - Prices, ASIN & Demand Signal (`henrycrawl/amazon-products-scraper`) Actor

Product research and price monitoring on Amazon without the Product Advertising API. Scrape search results into typed rows: price with an explicit currency, ASIN, brand, rating, review count and the bought-in-past-month demand signal. Rows in the wrong currency are flagged, not mixed in.

- **URL**: https://apify.com/henrycrawl/amazon-products-scraper.md
- **Developed by:** [Henry Crawl](https://apify.com/henrycrawl) (community)
- **Categories:** E-commerce, Lead generation
- **Stats:** 2 total users, 1 monthly users, 66.7% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.00 / 1,000 products

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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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 - Prices, ASIN & Demand Signal

**Product research and price monitoring on Amazon without the Product Advertising API.**
No seller account, no API credentials, no approval process — point it at a search and get
typed rows back.

Two things make this one different. The price **always carries an explicit currency**, and
any row that came back in the *wrong* currency is flagged rather than quietly mixed in. And
every row includes Amazon's **bought in past month** figure — the closest thing to a public
demand signal that Amazon exposes.

Common uses: sizing a category before sourcing, monitoring competitor prices and discounts,
tracking demand on a shortlist of ASINs, and feeding product data into a dashboard.

### What you get per product

| Field | Example | Notes |
|---|---|---|
| `asin` | `B0GP99ZYSH` | Amazon's own id, use it to deduplicate across runs |
| `title` | `Rambler 20 oz Stainless Steel Vacuum Insulated Tumbler` | |
| `brand` | `YETI` | Separated from the title |
| `price` / `currency` | `24.99` / `USD` | Number plus the currency it was quoted in |
| `priceRaw` | `$24.99` | Original string, kept for auditing |
| `listPrice` / `discountPercent` | `34.99` / `29` | When Amazon shows a struck-through price |
| **`currencyMismatch`** | `false` | **True means the request was geolocated elsewhere — see below** |
| `rating` | `4.8` | |
| `reviewCount` | `148600` | `148.6K` expanded to a real number |
| **`boughtInPastMonth`** | `2000` | From `2K+ bought in past month` |
| `badge` | `Overall Pick` | Also `Best Seller`, `Amazon's Choice` |
| `isPrime`, `isSponsored` | `true` / `false` | |
| `variants` | `3 sizes` | |
| `deliveryText` | `FREE delivery Wed, Aug 19` | |
| `imageUrl`, `productUrl` | | |
| `searchKeyword`, `pageNumber`, `amazonDomain`, `proxyCountry`, `scrapedAt` | | Provenance of every row |

### The currency problem, and what this actor does about it

Amazon prices by geography. Measured: requesting `amazon.com` from outside the United
States returns prices like `VND 919,222` with local delivery estimates — not USD. A
scraper that hands that back as a plain number silently corrupts every comparison built
on top of it.

This actor:

1. Pins the marketplace's own currency with a cookie before the first request.
2. Matches the proxy country to the marketplace you selected.
3. Derives the expected currency from `amazonDomain` and sets **`currencyMismatch: true`**
   on any row that still disagrees, plus a warning in the run log and a count in the
   run diagnostics.

So a bad run is visible instead of quietly wrong.

### Input

```json
{
  "keywords": ["yeti rambler 20 oz tumbler", "stanley quencher"],
  "amazonDomain": "www.amazon.com",
  "proxyCountry": "US",
  "sortBy": "relevance",
  "maxProducts": 500
}
```

Filters: marketplace, sort order, price range, Prime only, and optionally dropping
sponsored placements. Sponsored rows are kept by default because ad presence is useful
competitive data — every row carries `isSponsored` either way.

### The result cap is real

`maxProducts` stops the run at exactly that number, and duplicates are dropped on ASIN,
so the same product is never delivered — or billed — twice. The run also stops on its own
if three consecutive pages return nothing usable.

### Runs fail loudly, not silently

Every run writes a `DIAGNOSTICS` record with block rate, per-field fill rates and the
currency-mismatch count:

```json
{ "itemsExtracted": 500, "blockRate": "0%", "currencyMismatchRows": 0,
  "fieldCoverage": { "price": "97%", "boughtInPastMonth": "41%" } }
```

If nothing was extracted, or more than half the pages were blocked, the run is marked
**failed** with the reason.

### Typical uses

- Price and discount monitoring across a category
- Product research ranked by the bought-in-past-month signal rather than guesswork
- Brand share of shelf: who owns the first pages for a keyword, and how much is paid
- Feeding a repricing or catalogue pipeline with typed rows

### Notes and limits

- `boughtInPastMonth` and `badge` only appear where Amazon shows them, and are `null`
  elsewhere rather than estimated.
- This actor reads search results. Full review text lives behind a login on Amazon, so it
  is deliberately out of scope.
- Keep `maxConcurrency` low; Amazon rate limits per session.

### Support

If a field stops filling or you need a filter that is not exposed, open an issue on the
actor page with the input you used.

### What `isPrime` and `isSponsored` really tell you

**`isSponsored` is detected from the card's markup, not from its text.** Amazon marks ad
cards with an `AdHolder` class and a sponsored-label element; both were measured agreeing on
the same cards. The older text-only check silently returned zero sponsored rows on pages that
actually carried 24 of them, because this actor blocks stylesheets to save bandwidth and that
changes what `innerText` contains. Every run now logs `sponsoredSignals` so you can tell a
genuinely ad-free page from a broken selector.

**`isPrime` is usually `false`, and that is honest rather than missing.** Measured on
`amazon.com/s`: zero result cards carried any Prime marker at all. Amazon only paints that
badge for some sessions and locales, so treat `false` as "no badge shown to this request"
rather than "not a Prime item". Runs report `primeBadgesSeen` for the same reason.

### FAQ

**Do I need an Amazon API key or a seller account?**
No. This reads Amazon's public search pages. There is nothing to register for and no approval
process — you only need an Apify account.

**Why would a price come back in the wrong currency?**
Amazon prices by IP country. Requested from a Vietnamese IP, `amazon.com` returns figures like
`VND 919,222` with local delivery instead of USD. This actor pins the marketplace currency with
the `i18n-prefs` cookie, matches the proxy country to the marketplace, and then **verifies each
row** — anything that still comes back mismatched is flagged with `currencyMismatch: true`
instead of being averaged in with real USD prices.

**Is "bought in past month" reliable?**
It is Amazon's own figure, copied as shown and parsed to a number (`2K+` becomes `2000`). It
appears on most but not all listings — roughly three quarters in the runs measured — and is
`null` where Amazon does not display it, never estimated.

**Can it scrape reviews or product detail pages?**
No. This actor covers search results only. Amazon redirects `/product-reviews/` to a sign-in
page, so a review scraper would need an authenticated session and is a different product.

**How do I stop it from running up a bill?**
`maxProducts` is a hard stop. The run also fails loudly on zero items or a block rate above
50%, so you are never charged for a dataset that quietly came back half empty.

# Actor input Schema

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

Each keyword runs as its own Amazon search using the filters below.

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

Paste Amazon search or category URLs. Scraped in addition to any keywords.

## `amazonDomain` (type: `string`):

Which Amazon marketplace to search. The expected currency is derived from this.

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

Match this to the marketplace. Amazon prices by geography: requesting amazon.com from elsewhere returns local currency and local delivery, and those rows are flagged as unusable.

## `maxProducts` (type: `integer`):

The run stops at exactly this many products. Enforced, so you cannot be billed for more rows than you asked for.

## `sortBy` (type: `string`):

Amazon's own sort options.

## `minPrice` (type: `integer`):

Lower price bound, in the marketplace currency.

## `maxPrice` (type: `integer`):

Upper price bound, in the marketplace currency.

## `primeOnly` (type: `boolean`):

Restrict to Prime-eligible offers.

## `excludeSponsored` (type: `boolean`):

Drops paid placements. Off by default because ad presence is itself useful competitive data; every row carries isSponsored either way.

## `maxConcurrency` (type: `integer`):

Keep this low. Amazon rate limits per session and aggressive parallelism trades throughput for blocks.

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

Defaults to Apify residential proxy in the selected country. Amazon answers datacenter ranges with HTTP 503.

## Actor input object example

```json
{
  "keywords": [
    "yeti rambler 20 oz tumbler"
  ],
  "startUrls": [],
  "amazonDomain": "www.amazon.com",
  "proxyCountry": "US",
  "maxProducts": 100,
  "sortBy": "relevance",
  "primeOnly": false,
  "excludeSponsored": false,
  "maxConcurrency": 2,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

## `products` (type: `string`):

One row per search result: ASIN, title, brand, price with currency, list price and discount percent, rating, review count, bought-in-past-month, badge, Prime and sponsored flags, delivery text, image and product URL.

## `diagnostics` (type: `string`):

Block rate, per-field fill rates, and the number of rows that came back in the wrong currency.

# 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 = {
    "keywords": [
        "yeti rambler 20 oz tumbler"
    ]
};

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

# Prepare the Actor input
run_input = { "keywords": ["yeti rambler 20 oz tumbler"] }

# Run the Actor and wait for it to finish
run = client.actor("henrycrawl/amazon-products-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 '{
  "keywords": [
    "yeti rambler 20 oz tumbler"
  ]
}' |
apify call henrycrawl/amazon-products-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=henrycrawl/amazon-products-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

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