# Amazon Best Sellers Scraper | Top Products on 12 Stores (`genial_candlestand/amazon-best-sellers-scraper`) Actor

Get Amazon Best Sellers and New Releases charts: rank, ASIN, title, price in local currency, rating and reviews count, category path. 12 marketplaces (US, UK, DE, JP…), up to 100 ranks per chart, subcategories, no login.

- **URL**: https://apify.com/genial_candlestand/amazon-best-sellers-scraper.md
- **Developed by:** [Flowo](https://apify.com/genial_candlestand) (community)
- **Categories:** E-commerce
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.10 / 1,000 ranked products

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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 Best Sellers Scraper | Top Products on 12 Stores

![Amazon Best Sellers Scraper | Top Products on 12 Stores](https://api.apify.com/v2/key-value-stores/Ll7RrWtDkZYOrBvfE/records/amazon-com-bestseller-top-chart-lists-banner-194ef1f8.png)

Get the ranked products of Amazon Best Sellers and New Releases charts: rank in the chart, ASIN, product title, price in the store's own currency, star rating, number of ratings and the category path. It covers 12 Amazon stores (US, UK, DE, FR, IT, ES, CA, AU, JP, IN, MX, BR), any department or subcategory, and up to 100 ranks per chart.

### What does Amazon Best Sellers Scraper do?

Give the actor department names (for example `electronics`, `books`, `kitchen`), chart URLs copied from the browser, or switch on all departments of a store. It opens each chart and returns one flat row per ranked product, in the store's own currency. Prices are parsed with the store's decimal and thousands separators, so "R$ 1.199,90" becomes `1199.9` and "¥3,774" becomes `3774`.

It is built for sellers and brands doing product research, cross-border sellers comparing the same category across stores, analysts tracking ranks on a schedule, book publishers watching book charts, and AI agents that need "top sellers in X on Amazon Y". No login or API key is needed.

### How to scrape Amazon Best Sellers

![How Amazon Best Sellers Scraper works: Builds chart URLs from categories, marketplace and list types; Fetches each chart page over the Apify datacenter proxy; Loads ranks 31–100 through Amazon's own n](https://api.apify.com/v2/key-value-stores/Ll7RrWtDkZYOrBvfE/records/amazon-com-bestseller-top-chart-lists-how-a2b3255e.png)

1. Open the actor in Apify Console and choose a **Marketplace** (default US).
2. Enter **Categories** (department slugs such as `electronics`, or `department/nodeId` such as `electronics/172541`), or paste **Start URLs**, or tick **All departments**.
3. Pick **List types** (Best Sellers by default), the **Max items per list** and optionally a **Subcategory depth**.
4. Click Start and download the dataset as JSON, CSV or Excel, or read it through the API.

### How much does it cost to scrape Amazon Best Sellers?

Price per event by Apify plan:

| Event | Free | Bronze | Silver | Gold and above |
|---|---|---|---|---|
| Ranked product | $3.00 per 1,000 | $2.70 per 1,000 | $2.40 per 1,000 | $2.10 per 1,000 |
| Actor start | $0.00005 | $0.00005 | $0.00005 | $0.00005 |

A test run with the API example input below returned 100 rows in 14 s.

The actor uses pay per event. One paid event is one ranked product (one row) at $0.003 on the Free plan, which is $3.00 per 1,000 products; the plan discounts lower it. A small actor-start event of $0.00005 is charged once per run. Empty charts and failed pages are free.

| Scenario | Rows | Cost on the Free plan |
|---|---|---|
| One chart, all 100 ranks | 100 | about $0.30 |
| Two departments, 100 ranks each | 200 | about $0.60 |
| Top 10 of each of 12 departments | 120 | about $0.36 |
| One department on 12 stores, 100 ranks each | 1,200 | about $3.60 |

### Input

![Amazon Best Sellers Scraper input example: Categories, Marketplace, List types, All departments, Subcategory depth, Max items per list, Max items in total](https://api.apify.com/v2/key-value-stores/Ll7RrWtDkZYOrBvfE/records/amazon-com-bestseller-top-chart-lists-input-9f3b9dea.png)

| Field | Meaning |
|---|---|
| `categories` | Department slugs or `department/nodeId` of the selected marketplace |
| `marketplace` | `US`, `UK`, `DE`, `FR`, `IT`, `ES`, `CA`, `AU`, `JP`, `IN`, `MX` or `BR` (default `US`) |
| `listTypes` | `bestsellers` (default), `new-releases`, plus three types that are currently empty |
| `startUrls` | Chart URLs on any of the 12 hosts; the marketplace comes from the host |
| `allDepartments` | Chart every top-level department of the marketplace |
| `subcategoryDepth` | 0–3 levels of subcategories below each chart (default 0) |
| `maxItemsPerList` | 1–100 ranks per chart (default 100) |
| `maxItems` | Total rows per run (default 1000) |
| `proxyConfiguration` | Apify datacenter proxy by default |

Example:

```json
{
  "marketplace": "DE",
  "categories": ["ce-de", "books"],
  "listTypes": ["bestsellers", "new-releases"],
  "maxItemsPerList": 50
}
```

Department slugs differ by store (`ce-de` is Electronics on amazon.de, `kids` is toys on amazon.co.uk). An unknown slug returns 0 rows and a warning that lists the valid slugs.

### What data can you extract from Amazon Best Sellers?

![Amazon Best Sellers Scraper output example: Image, Rank, Product, Price, Currency, Rating](https://api.apify.com/v2/key-value-stores/Ll7RrWtDkZYOrBvfE/records/amazon-com-bestseller-top-chart-lists-output-a111169f.png)

| Field | Description |
|---|---|
| `position` | Rank in the chart, 1–100 |
| `asin` | Amazon product id (ASIN, or ISBN-10 for books) |
| `title` | Product title as shown on the chart |
| `url` | Product page `/dp/<ASIN>` on the store |
| `imageUrl` | Product image (300 px) |
| `price` | Numeric price in the store's currency; for "N offers from" cards the lowest offer |
| `currency` | ISO 4217 code of the price |
| `priceText` | Price as displayed, for example `$17.99` |
| `isLowestOfferPrice` | true when the price is the lowest of N offers |
| `offersCount` | Number of offers on "N offers from" cards |
| `rating` | Average star rating, 0–5 |
| `reviewsCount` | Number of ratings |
| `author` | Author of books, Kindle titles, or developer of apps |
| `format` | Hardcover, Paperback, Kindle Edition, Audio CD… |
| `marketplace` | Store of the chart (US, UK, DE…) |
| `listType` | bestsellers, new-releases, movers-and-shakers, most-wished-for or most-gifted |
| `listTitle` | Chart heading, e.g. "Best Sellers in Electronics" |
| `category` | Name of the charted category |
| `categoryId` | Department slug, or browse node id for a subcategory |
| `department` | Department slug the chart belongs to |
| `categoryPath` | Category path from the department down, joined by " > " |
| `listUrl` | Canonical URL of the chart |
| `scrapedAt` | When the row was extracted (ISO 8601) |

Example item (shortened):

```json
{
  "position": 2,
  "asin": "B0GJTXVN9Z",
  "title": "Apple AirTag (2nd Generation) - 4 Pack: Tracker for Keychain, Wallet, and More …",
  "url": "https://www.amazon.com/dp/B0GJTXVN9Z",
  "imageUrl": "https://images-na.ssl-images-amazon.com/images/I/611DjYhflAL._AC_UL300_SR300,200_.jpg",
  "price": 79.99,
  "currency": "USD",
  "priceText": "$79.99",
  "isLowestOfferPrice": false,
  "rating": 4.6,
  "reviewsCount": 12616,
  "marketplace": "US",
  "listType": "bestsellers",
  "listTitle": "Best Sellers in Electronics",
  "category": "Electronics",
  "categoryId": "electronics",
  "department": "electronics",
  "categoryPath": "Electronics",
  "listUrl": "https://www.amazon.com/Best-Sellers-Electronics/zgbs/electronics",
  "scrapedAt": "2026-11-03T10:56:49.607Z"
}
```

### Use cases

- Product research: see what sells in a department, at what price and with how many reviews.
- Cross-border comparison: run the same category on several stores and compare prices in local currencies.
- Daily rank tracking: schedule the actor and store the charts over time.
- Book and media charts: watch Books on .com, .co.uk and .de with `author` and `format`.
- Store snapshots: use `allDepartments` for the top ranks of every department.

### Limitations

- Amazon shows at most 100 ranks per chart; some charts are shorter.
- Movers & Shakers, Most Wished For and Most Gifted are currently empty on all 12 stores. They return 0 rows with a warning and are not charged.
- Only the 12 listed stores are supported; other Amazon hosts are an input error.
- `price`, `rating`, `author`, `format` and `offersCount` can be empty when the chart card does not show them.
- Amazon blocks some requests; the actor retries with new sessions, but a page can still fail and is then skipped with a warning.
- A department root is required for subcategories (`electronics/172541`); a bare node id is an input error.

### Tips and troubleshooting

- Fewer rows than expected: check `maxItemsPerList` and `maxItems` (default total 1000), and remember that some charts have fewer than 100 ranks.
- Zero rows for a department: the slug probably does not exist on that store. Read the warning in the run log, it lists the valid slugs.
- Subcategories: set `subcategoryDepth` (0–3) and give a department root; each subcategory chart is a separate chart with its own ranks.
- Pasting chart URLs in `startUrls` is the quickest way to match a chart you see in the browser; the store is taken from the host.
- Rank tracking: schedule the actor and compare `position` by `asin` using `scrapedAt`.
- Rows with `isLowestOfferPrice` true show the lowest of several offers, not the product's own price.

### API, MCP and integrations

Run the actor from your code with the same JSON input as in Console. Your API token is in [Console → Settings → API & Integrations](https://console.apify.com/settings/integrations).

**Python** (`pip install apify-client`):

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("genial_candlestand/amazon-best-sellers-scraper").call(run_input={"categories": ["electronics", "books"], "maxItemsPerList": 50})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)
```

**Node.js** (`npm install apify-client`):

```js
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('genial_candlestand/amazon-best-sellers-scraper').call({"categories": ["electronics", "books"], "maxItemsPerList": 50});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

**HTTP** — one request runs the actor and returns the results (runs up to 5 minutes; longer ones: [run asynchronously](https://docs.apify.com/api/v2/act-runs-post)):

```bash
curl -X POST "https://api.apify.com/v2/acts/genial_candlestand~amazon-best-sellers-scraper/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"categories":["electronics","books"],"maxItemsPerList":50}'
```

**AI agents (MCP).** Add the actor as a tool of the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp). Claude Code:

```bash
claude mcp add --transport http apify "https://mcp.apify.com?tools=genial_candlestand/amazon-best-sellers-scraper"
```

Claude Desktop, Cursor or VS Code: `{"mcpServers": {"apify": {"url": "https://mcp.apify.com?tools=genial_candlestand/amazon-best-sellers-scraper"}}}`. Then ask, for example:

- "Get the top 50 Amazon.de Best Sellers in books with price and rating"
- "List the 100 best selling electronics on amazon.com with ASIN and reviews count"
- "Compare New Releases in Books on amazon.co.uk and amazon.com"

**Integrations.** Run it on a schedule with [Apify Schedules](https://docs.apify.com/platform/schedules) and send the results to Google Sheets, Slack, Zapier, Make, n8n or your webhook — see [Apify integrations](https://docs.apify.com/platform/integrations).

### FAQ

**Is it legal to scrape Amazon Best Sellers?**<br>
The actor reads public chart pages that anyone can open without logging in. It returns product data only, no personal data. You are responsible for using the data in line with Amazon's terms and the law in your country.

**Why are there no Movers & Shakers rows?**<br>
Amazon currently serves these charts empty on all 12 stores.

**Which currency do I get?**<br>
The native currency of the store; the `currency` field holds its ISO code.

**How is it different from other Amazon Best Sellers actors?**<br>
Each row has the ASIN, star rating and ratings count, which the output of the market leader in this niche lacks, and the `marketplace` field covers 12 stores. The price is $3.00 per 1,000 rows on the Free plan against $5.90 for that leader.

### Also useful

- [Naver Shopping Scraper](https://apify.com/genial_candlestand/naver-shopping-product-search-scraper) — compare e-commerce prices, ratings and reviews on Korea's largest shopping site
- [Woolworths Product Scraper](https://apify.com/genial_candlestand/woolworths-product-scraper) — track retail prices, specials and stock at an Australian retailer
- [Google Trends Scraper](https://apify.com/genial_candlestand/google-trends-scraper) — check search interest by region and related queries for products you research
- [Google Trends Trending Now Scraper](https://apify.com/genial_candlestand/google-trending-now-scraper) — spot trending searches by country to find rising products

# Actor input Schema

## `categories` (type: `array`):

Departments to chart, one per line: a slug such as electronics, books or kitchen, or department/nodeId for a subcategory (electronics/172541). Slugs differ by marketplace; an unknown slug returns 0 items and a warning listing valid slugs.

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

Amazon store used for Categories and All departments. Prices come in its local currency. Start URLs use the store of their own host.

## `listTypes` (type: `array`):

Which Amazon charts to fetch for Categories and All departments (Start URLs keep the chart of their URL). Best Sellers and New Releases have data on every marketplace; Movers & Shakers, Most Wished For and Most Gifted are currently empty on all 12 marketplaces and return 0 items with a warning.

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

Chart pages copied from the browser on amazon.com, .co.uk, .de, .fr, .it, .es, .ca, .com.au, .co.jp, .in, .com.mx or .com.br, e.g. https://www.amazon.de/gp/bestsellers/ce-de or https://www.amazon.com/Best-Sellers-Books/zgbs/books. The marketplace comes from the host. Any of the five chart types; a chart root (…/gp/bestsellers) means all its departments. Product, search and other-country URLs are an input error.

## `allDepartments` (type: `boolean`):

Fetch the chart of every top-level department of the selected Marketplace (25–40 departments depending on the store) for each selected list type. Combine with Max items to cap the cost (40 departments × 100 = 4,000 products).

## `subcategoryDepth` (type: `integer`):

Also fetch the charts of subcategories: 0 = only the given categories, 1 = plus their direct subcategories (Electronics → Headphones, Cell Phones…), 2–3 = deeper levels. Each subcategory is its own list of up to Max items per list. Works on every marketplace.

## `maxItemsPerList` (type: `integer`):

How many ranks to take from each chart, from #1 down. Amazon shows at most 100 per chart; some charts have fewer.

## `maxItems` (type: `integer`):

Stop the run after this many products across all lists. Raise it for All departments or deep subcategory crawls.

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

Apify datacenter proxy works for all 12 marketplaces and is the cheapest; switch to the RESIDENTIAL group only if you see blocked/captcha errors. Prices stay in the marketplace currency whatever the proxy country. Running without a proxy gets captchas after ~20 pages.

## Actor input object example

```json
{
  "categories": [
    "electronics",
    "books"
  ],
  "marketplace": "US",
  "listTypes": [
    "bestsellers"
  ],
  "allDepartments": false,
  "subcategoryDepth": 0,
  "maxItemsPerList": 100,
  "maxItems": 1000,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

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

Dataset with one row per ranked product

# 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 = {
    "categories": [
        "electronics",
        "books"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("genial_candlestand/amazon-best-sellers-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 = { "categories": [
        "electronics",
        "books",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("genial_candlestand/amazon-best-sellers-scraper").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 '{
  "categories": [
    "electronics",
    "books"
  ]
}' |
apify call genial_candlestand/amazon-best-sellers-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,genial_candlestand/amazon-best-sellers-scraper"
        }
    }
}
```

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/MP6fVDakM2bEfGMpB/builds/ch6eFtgwDelPLhkRc/openapi.json
