# Amazon Best Sellers & New Releases Scraper — 10+ Marketplaces (`foxlabs/amazon-bestsellers-scraper`) Actor

Scrape full #1-#100 Amazon Best Sellers and Hot New Releases across 10 marketplaces (US, UK, DE, FR, IT, ES, CA, JP, IN, AU). Extracts rank, ASIN, title, price, rating, review count, images, and subcategories with zero login or keys.

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

## Pricing

$1.20 / 1,000 ranked amazon 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/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

<p align="center">
  <img src="https://img.shields.io/badge/Pay--Per--Event-%241.20_%2F_1K_Products-00C853?style=for-the-badge" alt="Pay-Per-Event" />&nbsp;
  <img src="https://img.shields.io/badge/Full_Top_100-10_Global_Marketplaces-2962FF?style=for-the-badge" alt="10 Marketplaces" />&nbsp;
  <img src="https://img.shields.io/badge/AI_Agent_Ready-MCP_%26_x402-7C4DFF?style=for-the-badge" alt="MCP & x402 Ready" />&nbsp;
  <img src="https://img.shields.io/badge/Dual_Runtime-Batch_%2B_Standby_API-FF6D00?style=for-the-badge" alt="Batch + Standby API" />
</p>

## Amazon Best Sellers & New Releases Scraper — 10+ Marketplaces 🚀

**foXLabs E-Commerce & Retail Intelligence Series:** [Shopify Store Data](https://apify.com/foxlabs/shopify-store-data) · [Shopify App Store Scraper](https://apify.com/foxlabs/shopify-app-store-scraper) · [Trustpilot Reviews](https://apify.com/foxlabs/trustpilot-reviews-scraper) · [Product Hunt Launch Leads](https://apify.com/foxlabs/producthunt-launch-leads) · [Apple App Store Scraper](https://apify.com/foxlabs/apple-app-store-scraper) · [Whop Marketplace Scraper](https://apify.com/foxlabs/whop-marketplace-scraper)

🎉 Extract complete, gap-free **`#1–#100` Amazon Best Sellers and Hot New Releases** product rankings across **10 global Amazon marketplaces** (`amazon.com`, `co.uk`, `de`, `fr`, `it`, `es`, `ca`, `co.jp`, `in`, `com.au`) — including lazy-loaded **ranks `#31–#50` and `#81–#100`** that ordinary HTML scrapers miss, with **no Amazon PA-API keys, no login, no cookies and zero browser overhead**.

Built for Amazon FBA sellers, e-commerce brand managers, retail price & rank velocity trackers, consumer-goods equity analysts and autonomous AI agents.

### 🔍 What is the Amazon Best Sellers & New Releases Scraper — and when should you use it?

Amazon refreshes its Best Sellers (`/zgbs/`) and Hot New Releases (`/gp/new-releases/`) leaderboards every hour, making them one of the highest-signal live demand indicators in global retail. However, scraping those charts reliably hits two classic traps:

- Basic HTML scrapers capture only the first 30 products rendered in initial HTML (`#1–#30` on page 1 and `#51–#80` on page 2), silently dropping **40% of the chart** (`#31–#50` and `#81–#100`).
- Heavy headless-browser scrapers spin up 2 GB – 4 GB Chromium instances to scroll lazy-loaded grids, driving up run times and compute bills.

This Actor captures all 100 positions cleanly inside a fast `256 MB` HTTP runtime:

- **Complete `#1–#100` gap-free rankings** — resolves both initial positions and lazy-loaded batches so every rank from `#1` through `#100` is delivered in exact numerical order.
- **Best Sellers + Hot New Releases (`chartType`)** — extract `"bestsellers"`, `"new-releases"`, or `"both"` in a single run to spot both established category leaders and breakout product launches.
- **10 global Amazon marketplaces (`domain`)** — supports US (`amazon.com`), UK (`amazon.co.uk`), Germany (`amazon.de`), France (`amazon.fr`), Italy (`amazon.it`), Spain (`amazon.es`), Canada (`amazon.ca`), Japan (`amazon.co.jp`), India (`amazon.in`) and Australia (`amazon.com.au`).
- **Department slugs, deep niche URLs & child subcategory crawling** — pass human-readable department slugs (`"electronics"`, `"beauty"`, `"kitchen"`), paste deep level-4 subcategory URLs (`categoryUrls`), or enable `crawlSubcategories: true` to automatically expand immediate child subcategories.

**Use it when you need:** hourly or daily rank-velocity tracking across Amazon categories; FBA product discovery via Hot New Releases (`new-releases`); cross-border assortment & pricing comparisons across US, UK, EU and Japan; or feeding top-ranked ASINs into downstream enrichment pipelines.

**Use something else when:** you need **keyword search result pages (`/s?k=…`)** or **individual customer review text** (this Actor focuses on `#1–#100` category leaderboard intelligence, with optional `enrichProductDetails: true` for full `/dp/<ASIN>` product specifications, brand, Buy Box seller, Prime status, bullet points, and BSR sub-ranks).

### 🤖 Use with AI agents (MCP, Claude, Cursor & x402)

**Already connected to the Apify MCP server?** Ask your AI assistant to call `foxlabs/amazon-bestsellers-scraper`.

- **Hosted MCP URL (zero install):** `https://mcp.apify.com?tools=foxlabs/amazon-bestsellers-scraper`
- **Local stdio config (Claude Desktop, Cursor, Cline, Windsurf):**

```json
{
  "mcpServers": {
    "amazon-bestsellers-scraper": {
      "command": "npx",
      "args": ["-y", "@apify/actors-mcp-server", "--tools", "foxlabs/amazon-bestsellers-scraper"],
      "env": { "APIFY_TOKEN": "YOUR_APIFY_TOKEN" }
    }
  }
}
```

**Your agent can pay for its own runs.** This Actor uses pay-per-event pricing and supports agentic micropayments, so autonomous agents can invoke runs and settle usage over **x402 (USDC on Base)** or **Skyfire** as well as standard Apify tokens. Billing is `$0.0012` per delivered ranked `product` row; diagnostic `status` rows are `$0.00`.

Copy-paste prompt for Claude, ChatGPT, Cursor or any MCP-enabled assistant:

```text
Use the Apify Actor `foxlabs/amazon-bestsellers-scraper` to extract `#1–#100` Amazon Best Sellers or Hot New Releases across 10 global Amazon marketplaces.

Input fields:
- `categories`: array of department slugs (e.g. ["electronics", "beauty", "kitchen", "books", "pet-supplies"])
- `categoryUrls`: optional array of direct Amazon /zgbs/ or /gp/new-releases/ subcategory URLs
- `domain`: "amazon.com" (default) | "amazon.co.uk" | "amazon.de" | "amazon.fr" | "amazon.it" | "amazon.es" | "amazon.ca" | "amazon.co.jp" | "amazon.in" | "amazon.com.au"
- `chartType`: "bestsellers" (default) | "new-releases" | "both"
- `maxItemsPerCategory`: integer 1..100 (default 50)
- `crawlSubcategories`: boolean (default false) — also scrape immediate child subcategories
- `maxSubcategories`: integer 1..30 (default 3)
- `enrichProductDetails`: boolean (default false) — enrich ranked ASINs with `/dp/<ASIN>` brand, seller, Prime, listPrice, bullets, description & BSR sub-ranks

Start with:
{"categories":["electronics"],"domain":"amazon.com","chartType":"bestsellers","maxItemsPerCategory":50}
```

**Things you can ask your AI agent:**

- *"Pull the Top 100 Hot New Releases in Beauty on amazon.com and list products priced over $25 that have fewer than 200 reviews (low-competition FBA breakout signals)."*
- *"Compare the Top 50 Best Sellers in Electronics across amazon.com, amazon.co.uk and amazon.de — which brands dominate all three markets?"*
- *"Scrape this Espresso Machines subcategory URL on amazon.com with `chartType: 'both'` and summarize median price and star rating."*

The machine-readable Actor summary, MCP metadata and OpenAPI schema live at `https://apify.com/foxlabs/amazon-bestsellers-scraper.md`.

### 📋 Overview

Everything needed to capture complete `#1–#100` Amazon category leaderboards across 10 countries in seconds — without PA-API approval, Associate sales quotas or heavy browser containers.

| Property | Details |
|---|---|
| **Public data source** | Public Amazon Best Sellers (`/zgbs/`) & Hot New Releases (`/gp/new-releases/`) charts |
| **Supported marketplaces** | 10 domains: `.com`, `.co.uk`, `.de`, `.fr`, `.it`, `.es`, `.ca`, `.co.jp`, `.in`, `.com.au` |
| **Authentication required** | None — zero Amazon Product Advertising API (PA-API) keys, cookies or accounts |
| **Container footprint** | Lightweight `256 MB` HTTP runtime (~5–10 seconds per 100 ranked products) |
| **Output row types (`rowType`)** | `product` (`$0.0012`), `status` (`$0.00` diagnostic rows) |
| **Deduplication & restart safety** | Deterministic `rowKey` (`<domain>:<chartType>:<categorySlug>:<asin>`) — zero duplicate rows or double charges |
| **Execution modes** | Standard Batch Dataset runs + synchronous Standby HTTP API (`GET /`, `GET /health`, `POST /scrape`) |

**Why teams pick this Actor:**

- 🏆 **True `#1–#100` completeness** — delivers ranks `#31–#50` and `#81–#100` that naive HTML scrapers drop.
- 🔥 **Best Sellers + Hot New Releases in one tool** — toggle `chartType: "both"` to capture established winners alongside fast-rising new launches.
- 🌍 **10-country cross-border normalization** — localized slug mapping (e.g. `electronics` on `amazon.de` or `amazon.co.jp`), ISO 4217 currency detection (`USD`, `GBP`, `EUR`, `CAD`, `JPY`, `INR`, `AUD`), and high-resolution image upgrading.
- ⚡ **10× lighter than browser scrapers** — runs inside `256 MB` RAM at `$1.20 / 1,000` products.
- 🛡️ **Strict `null` discipline** — multi-offer or unquoted digital items emit `price: null` (never fake `0`) and populate `offersCount` when shown.

### ✨ Key Features

- 🔢 **Gap-Free Top-100 Extraction** — Captures every ranked product from `#1` to `maxItemsPerCategory` (up to `100` per category per chart type) with exact integer `rank` and 10-character `asin`.
- 🧭 **Department Slugs + Deep Subcategory URLs** — Combine simple slugs (`"electronics"`, `"kitchen"`, `"pet-supplies"`, `"toys-and-games"`) in `categories` with arbitrarily deep level-3/level-4 URLs in `categoryUrls`.
- 🌳 **Controlled Subcategory Expansion (`crawlSubcategories`)** — Automatically discovers immediate child subcategories from department sidebars up to `maxSubcategories` (`1`–`30`), expanding exactly one level so budgets never spiral out of control.
- 💱 **Multi-Marketplace Currency & Language Handling** — Automatically sets `currency` (`USD`, `GBP`, `EUR`, `CAD`, `JPY`, `INR`, `AUD`), preserves raw localized `priceFormatted` (`"$79.99"`, `"£49.95"`, `"29,99 €"`), and requests English labels where supported on non-English domains.
- 🖼️ **Upgraded High-Resolution Product Images** — Emits both standard thumbnail `imageUrl` and upgraded `highResImageUrl` (`900px+`) ready for dashboards and catalog UIs.
- 📈 **Hourly Schedule Ready** — Fast ~5–10s category sweeps make hourly rank-velocity tracking practical and affordable.

### 🎬 Quick Start (API & Standby HTTP)

**1. Synchronous Batch API call (returns clean JSON records directly):**

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

**2. Real-time Standby HTTP API (`POST /scrape`):**

```bash
curl -X POST "https://foxlabs--amazon-bestsellers-scraper.apify.actor/scrape?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"categories":["beauty"],"domain":"amazon.com","chartType":"new-releases","maxItemsPerCategory":20}'
```

### 🚀 Getting Started (3 steps)

1. **Pick categories or paste chart URLs** — Add department slugs in **Categories** (`"electronics"`, `"beauty"`, `"kitchen"`) or paste specific `/zgbs/` or `/gp/new-releases/` URLs into **Category URLs**.
2. **Choose marketplace, chart & depth** — Select **Domain** (`amazon.com`, `amazon.co.uk`, `amazon.de`, etc.), **Chart type** (`bestsellers`, `new-releases`, `both`), and **Max items per category** (`1`–`100`).
3. **Run & export** — Click **Start** and download your ranked products as JSON, CSV, Excel, Parquet or XML.

### 📥 Input & Filters

```json
{
  "categories": ["electronics", "kitchen"],
  "categoryUrls": [
    "https://www.amazon.com/Best-Sellers-Electronics-Headphones-Earbuds/zgbs/electronics/172541"
  ],
  "domain": "amazon.com",
  "chartType": "both",
  "maxItemsPerCategory": 100,
  "crawlSubcategories": false,
  "maxSubcategories": 3,
  "enrichProductDetails": false
}
```

| Field | Type | Default | Description |
|---|---|---|---|
| `categories` | `array<string>` | `["electronics"]` | Department slugs to scrape on the selected `domain` (`electronics`, `books`, `beauty`, `kitchen`, `toys-and-games`, `computers`, `sports-and-outdoors`, `pet-supplies`, `video-games`, etc.). |
| `categoryUrls` | `array<string>` | `[]` | Direct Amazon `/zgbs/`, `/gp/bestsellers/`, or `/gp/new-releases/` URLs (any of the 10 supported domains). |
| `domain` | `string` | `"amazon.com"` | Default marketplace domain for `categories`: `amazon.com`, `amazon.co.uk`, `amazon.de`, `amazon.fr`, `amazon.it`, `amazon.es`, `amazon.ca`, `amazon.co.jp`, `amazon.in`, `amazon.com.au`. |
| `chartType` | `string` | `"bestsellers"` | Leaderboard type: `"bestsellers"`, `"new-releases"`, or `"both"`. |
| `maxItemsPerCategory` | `integer` | `50` | Maximum ranked products extracted per category per chart (`1`–`100`). |
| `crawlSubcategories` | `boolean` | `false` | When `true`, also scrapes immediate child subcategories discovered in each parent category's sidebar. |
| `maxSubcategories` | `integer` | `3` | Maximum child subcategories crawled per parent department when `crawlSubcategories` is `true` (`1`–`30`). |
| `enrichProductDetails` | `boolean` | `false` | Optional `/dp/<ASIN>` enrichment (`$0` extra PPE charge): populates `brand`, `manufacturer`, `sellerName`, `isPrime`, `availability`, `listPrice`, `discountPct`, `bulletPoints`, `description`, `bsrRanks`, `dimensions`, `itemWeight`, `modelNumber`, `dateFirstAvailable`, `galleryImageUrls`, and `categoriesBreadcrumb`. |
| `proxyConfiguration` | `object` | `{"useApifyProxy": true}` | Managed automatically via Apify Proxy. |

**Copy-paste input recipes:**

- **Full `#1–#100` Best Sellers + Hot New Releases in 3 FBA categories:**
  `{"categories":["beauty","pet-supplies","kitchen"],"domain":"amazon.com","chartType":"both","maxItemsPerCategory":100}`
- **Deep niche subcategory URL + 5 child subcategories (`crawlSubcategories: true`):**
  `{"categories":[],"categoryUrls":["https://www.amazon.com/Best-Sellers-Electronics-Headphones-Earbuds/zgbs/electronics/172541"],"maxItemsPerCategory":50,"crawlSubcategories":true,"maxSubcategories":5}`
- **Multi-country EU + UK comparison in a single batch:**
  `{"categories":["electronics"],"categoryUrls":["https://www.amazon.co.uk/Best-Sellers-Electronics/zgbs/electronics","https://www.amazon.fr/gp/bestsellers/electronics"],"domain":"amazon.de","chartType":"bestsellers","maxItemsPerCategory":50}`

### 📤 Output Schema & Real Sample Record

Every Dataset record carries `rowType` (`"product"` or free diagnostic `"status"`) and a deterministic `rowKey` (`<domain>:<chartType>:<categorySlug>:<asin>`).

| Field | Type | Description |
|---|---|---|
| `rowKey` | `string` | Deterministic unique key `<domain>:<chartType>:<categorySlug>:<asin>` |
| `rowType` | `string` | `"product"` (billable) or `"status"` (free diagnostic row) |
| `rank` | `integer` | Exact chart position (`1`–`100`) |
| `asin` | `string` | 10-character Amazon Standard Identification Number |
| `title` | `string` | Full product title |
| `price` | `number \| null` | Parsed numeric price (`null` when Amazon omits Buy Box price or shows multi-offer count only) |
| `priceFormatted` | `string \| null` | Exact localized price string (`"$11.99"`, `"£49.95"`, `"29,99 €"`) |
| `currency` | `string` | ISO 4217 marketplace currency (`USD`, `GBP`, `EUR`, `CAD`, `JPY`, `INR`, `AUD`) |
| `rating` | `number \| null` | Customer star rating average (`0`–`5`, e.g. `4.4`) |
| `reviewsCount` | `integer \| null` | Total verified customer rating count |
| `offersCount` | `integer \| null` | Third-party offer count when primary Buy Box price is hidden (`"14 offers from…"`) |
| `categoryName` / `categorySlug` | `string` | Clean category display name (`"Electronics"`) and identifier slug |
| `chartType` / `domain` | `string` | `"bestsellers"` or `"new-releases"` · marketplace domain (`"amazon.com"`) |
| `productUrl` | `string` | Direct canonical ASIN URL (`https://www.<domain>/dp/<asin>`) |
| `imageUrl` / `highResImageUrl` | `string` | Standard thumbnail URL and upgraded high-resolution image URL |
| `detailsEnriched` | `boolean` | `true` when `/dp/<ASIN>` enrichment (`enrichProductDetails: true`) succeeded on the row |
| `brand` / `manufacturer` / `sellerName` | `string \| null` | Brand name, manufacturer, and active Buy Box seller (`enrichProductDetails: true`) |
| `isPrime` / `availability` | `boolean \| null` / `string \| null` | Amazon Prime fulfillment indicator and stock availability message (`"In Stock"`) |
| `listPrice` / `discountPct` | `number \| null` | Reference strike-through list price and percentage savings vs. current Buy Box price |
| `bulletPoints` / `description` | `array<string>` / `string \| null` | Feature bullet list and clean product description text |
| `bsrRanks` / `categoriesBreadcrumb` | `array<object>` / `array<string>` | Multi-level Best Sellers Ranks (`{ rank, category }`) and full Amazon category breadcrumb path |
| `dimensions` / `itemWeight` / `modelNumber` / `dateFirstAvailable` | `string \| null` | Technical package/product dimensions, weight, manufacturer model number, and catalog launch date |
| `galleryImageUrls` | `array<string>` | High-resolution gallery image URLs from the product page |

#### Real sample record (from live platform verification `8TN5pLCtTEV8WuqNg`, 2026-11-14)

```json
{
  "rowType": "product",
  "rowKey": "amazon.com:bestsellers:electronics:B08JHCVHTY",
  "rank": 1,
  "asin": "B08JHCVHTY",
  "title": "Blink Plus Plan with monthly auto-renewal",
  "price": 11.99,
  "priceFormatted": "$11.99",
  "currency": "USD",
  "rating": 4.4,
  "reviewsCount": 281971,
  "offersCount": null,
  "categoryName": "Electronics",
  "categorySlug": "electronics",
  "chartType": "bestsellers",
  "domain": "amazon.com",
  "productUrl": "https://www.amazon.com/dp/B08JHCVHTY",
  "imageUrl": "https://images-na.ssl-images-amazon.com/images/I/31YHGbJsldL._AC_UL300_SR300,200_.png",
  "highResImageUrl": "https://images-na.ssl-images-amazon.com/images/I/31YHGbJsldL._AC_UL900_SR900,600_.png"
}
```

Every completed run also writes a `SOURCE_REPORT` telemetry record to the default Key-Value Store.

### 🧪 Data Quality — Measured

Verified on the Apify platform across QA runs (`3F4PqYQ8zqt8S6l2P`, `sRkgqyx5nPLPpGbFr`, `9fwiy3PQOpe78yxi6`) and live D+0 billing verification (`8TN5pLCtTEV8WuqNg`, `3DXc9EDarBnw3EMLw` on 2026-11-14):

- **Gap-free `#1–#100` rank continuity:** Verified `100 / 100` sequential ranks (`#1` through `#100`) with `100%` `asin`, `title`, `rank`, `productUrl` and `imageUrl` completeness.
- **100% row uniqueness:** Deduplicated per category/chart by `<domain>:<chartType>:<categorySlug>:<asin>`, while allowing the same ASIN to appear accurately if it ranks in both a parent department and a child subcategory.
- **Exact billing alignment:** Live D+0 run `8TN5pLCtTEV8WuqNg` (`10` products) settled at `{product: 10}`, and empty-input run `3DXc9EDarBnw3EMLw` (`1` diagnostic `status` row) settled at `{product: 0}`.

### ⏱️ Performance — Measured

Measured on the Apify platform at the default **`256 MB`** memory tier:

- **~5–10 seconds per 100 ranked products:** Full 100-item category sweeps finish in single-digit seconds with peak RAM around `75–95 MB` inside a `256 MB` container.
- **Automatic session rotation:** Transient marketplace challenge pages are detected automatically and retried on a fresh session cleanly.
- **Migration idempotency:** Container restarts inspect existing `rowKey` items in the run's Dataset and skip already-delivered products.

### 💼 Use Cases

1. **FBA Breakout Product Discovery (`chartType: "new-releases"`)**
   - *Input:* `{"categories":["kitchen","pet-supplies","beauty"],"domain":"amazon.com","chartType":"new-releases","maxItemsPerCategory":100}`
   - *Output:* 300 top-selling newly launched ASINs with `rank`, `price`, `rating` and `reviewsCount`.
   - *Business action:* Filter for products ranked `#1–#30` in Hot New Releases with `price >= 25` and `reviewsCount < 150` to spot underserved high-velocity FBA niches early.

2. **Hourly Share-of-Shelf & Rank Velocity Monitoring**
   - *Input:* `{"categories":[],"categoryUrls":["https://www.amazon.com/Best-Sellers-Electronics-Headphones-Earbuds/zgbs/electronics/172541"],"chartType":"bestsellers","maxItemsPerCategory":100}`
   - *Output:* Complete hourly `#1–#100` snapshot of your category with competitor prices and review counts.
   - *Business action:* Correlate competitor Lightning Deals or price cuts directly against hourly Best Seller rank movements.

3. **Cross-Border Assortment Arbitrage (US vs. UK/EU/JP)**
   - *Input:* `{"categories":["electronics"],"categoryUrls":["https://www.amazon.co.uk/Best-Sellers-Electronics/zgbs/electronics","https://www.amazon.co.jp/gp/bestsellers/electronics"],"domain":"amazon.com","maxItemsPerCategory":50}`
   - *Output:* Top 50 Electronics ASINs across US (`USD`), UK (`GBP`) and Japan (`JPY`) in one dataset.
   - *Business action:* Spot products dominating US charts that have not yet launched on European or APAC Amazon marketplaces.

4. **Automated Subcategory Tree Mapping (`crawlSubcategories: true`)**
   - *Input:* `{"categories":["sports-and-outdoors"],"domain":"amazon.com","maxItemsPerCategory":50,"crawlSubcategories":true,"maxSubcategories":10}`
   - *Output:* Parent department chart plus up to 10 immediate child subcategory leaderboards (`550` ranked products).
   - *Business action:* Map category pricing and top ASINs across an entire retail vertical in a single API call.

### 🔗 Integrations (Node.js, Python, n8n, Make & Clay)

#### JavaScript / Node.js (`apify-client`)

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

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('foxlabs/amazon-bestsellers-scraper').call({
    categories: ['electronics'],
    domain: 'amazon.co.uk',
    chartType: 'both',
    maxItemsPerCategory: 50,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Fetched ${items.length} ranked Amazon products`, items[0]);
```

#### Python (`apify-client` v3)

```python
import os
from apify_client import ApifyClient

client = ApifyClient(os.environ["APIFY_TOKEN"])
run = client.actor("foxlabs/amazon-bestsellers-scraper").call(
    run_input={
        "categories": ["electronics", "books"],
        "domain": "amazon.com",
        "chartType": "bestsellers",
        "maxItemsPerCategory": 100,
    }
)

for item in client.dataset(run.default_dataset_id).iterate_items():
    if item["rowType"] == "product":
        print(f"#{item['rank']} {item['asin']} - {item['title']} ({item['priceFormatted']})")
```

*(Written for `apify-client` v3 where `call()` returns a `Run` object exposing `run.default_dataset_id`; on `apify-client` v1/v2 use `run["defaultDatasetId"]`.)*

#### n8n, Make, Zapier & Clay

- **Hourly rank tracker (n8n / Make / Zapier):** Schedule hourly or daily runs → push `asin`, `rank`, `price` and `reviewsCount` into BigQuery, Snowflake, Postgres or Google Sheets → alert Slack if your ASIN drops out of the Top 20.
- **Standby HTTP API:** Call `POST https://foxlabs--amazon-bestsellers-scraper.apify.actor/scrape` from AI agents, internal dashboards or Clay workflows for synchronous JSON responses.

### 📊 Pricing (Pay-Per-Event)

Simple, predictable **Pay-Per-Event (PPE)** billing — **$1.20 per 1,000 ranked products**:

| Event Name | Trigger | Price per Item | Price per 1,000 |
|---|---|---|---|
| `product` | Once per unique `rowType: "product"` ranked item delivered | **$0.0012** | **$1.20 / 1,000** |
| `status` *(diagnostic)* | Empty input, invalid non-chart URL, or unfound category slug note | **$0.00 (Free)** | **$0.00** |

**Worked cost examples:**

- **1 full Top-100 category (`maxItemsPerCategory: 100`):** `100 × $0.0012` = **$0.12**
- **5 categories × Best Sellers + New Releases (`chartType: "both"`, `1,000` products):** `1,000 × $0.0012` = **$1.20**
- **Daily tracking of 1 category (`Top 50`) for 30 days (`1,500` products/month):** `1,500 × $0.0012` = **$1.80 / month**

**Billing guarantees:**

- **Zero proxy or browser surcharges:** Apify Proxy rotation is included inside the `$0.0012` per-product rate.
- **Diagnostic rows are `$0.00`:** Invalid URLs and empty-input notices emit `rowType: "status"` at zero cost.
- **Exact spend cap support:** Configure **Maximum cost per run** in Apify options; `ChargingManager` stops collection cleanly as soon as your budget cap is met. *(Note: if Apify applies its platform `apify-actor-start` fee on your plan, that start event applies when a run starts, including runs that return zero billable rows.)*

### ❓ Frequently Asked Questions (FAQ)

#### Do I need Amazon Product Advertising API (PA-API) keys, cookies, or residential proxies?

No. Amazon's PA-API requires an approved Associates account with ongoing qualified-sales quotas and still restricts bulk leaderboard scraping. This Actor runs 100% keylessly on our infrastructure using default Apify Proxy management — no Amazon login, no API keys and no custom proxy setup required.

#### How does this Actor capture all 100 products when initial Amazon HTML shows only 30?

Amazon Best Sellers and Hot New Releases pages split each 50-item page into an initial batch of 30 products (`#1–#30` on page 1, `#51–#80` on page 2) and a lazy-loaded second batch of 20 products (`#31–#50` on page 1, `#81–#100` on page 2). Our runtime automatically requests both batches within the same page session so every rank from `#1` through `#100` is delivered without gaps.

#### Why is `price` occasionally `null` on certain ranked ASINs?

Digital subscriptions (such as Kindle Unlimited or Blink plans in certain regions), out-of-Buy-Box listings sold exclusively through third-party "See All Buying Options" drawers (`"18 offers from $12.99"`), or pre-order media titles sometimes omit a primary Buy Box price on Amazon's chart card. Rather than fabricating `price: 0`, the Actor emits `price: null` and populates `offersCount` whenever Amazon displays an offer count.

#### Which department slugs work out of the box in `categories`?

Built-in slugs include `electronics`, `books`, `beauty`, `kitchen`, `toys-and-games`, `computers`, `sports-and-outdoors`, `pet-supplies`, `office-products`, `video-games`, `automotive`, `baby-products`, `software`, `fashion`, and `home-garden`. Common regional slug differences (for example `electronics` mapping to `ce-de` on `amazon.de`) are handled automatically.

#### How do I scrape deep level-3 or level-4 niche subcategories (like Espresso Machines)?

Open the exact Best Sellers (`/zgbs/...`) or Hot New Releases (`/gp/new-releases/...`) subcategory page in your browser, copy its URL, and paste it into `categoryUrls` (setting `"categories": []` if you do not want the default `"electronics"` department included). Any depth in Amazon's category tree works via `categoryUrls`.

#### Can I mix `categoryUrls` from multiple countries (`amazon.com`, `amazon.co.uk`, `amazon.de`) in one run?

Yes. Every URL placed in `categoryUrls` automatically detects its own marketplace hostname (`amazon.co.uk`, `amazon.de`, `amazon.co.jp`, etc.) and maps its local ISO 4217 `currency` (`GBP`, `EUR`, `JPY`), independent of the `domain` dropdown (which applies to bare slugs in `categories`).

#### Are non-English marketplaces (`amazon.de`, `amazon.fr`, `amazon.co.jp`) returned with English labels?

When resolving slugs on `amazon.de`, `amazon.fr`, `amazon.it`, `amazon.es` and `amazon.co.jp`, the Actor requests Amazon's English interface parameter (`language=en_GB`) so `categoryName` and translated product titles are as uniform as possible across cross-border datasets while keeping local marketplace prices and currencies intact.

#### Does `crawlSubcategories: true` crawl the entire Amazon tree recursively?

No. To prevent runaway multi-thousand-category runs, `crawlSubcategories: true` expands **strictly one level deep** (the immediate child subcategories listed in the sidebar of your input categories) and stops at `maxSubcategories` (default `3`, configurable `1`–`30` per parent category).

#### How often does Amazon refresh Best Sellers and Hot New Releases?

Amazon recalculates both Best Sellers and Hot New Releases leaderboards roughly once per hour based on recent order velocity. Scheduling this Actor hourly or every 6–24 hours via Apify Schedules (`/schedule`) or n8n/Make gives you a clean time-series table of rank climbs, drops and new entrants.

#### Why can the same ASIN appear twice if I scrape both Electronics and Headphones?

In Amazon's catalog, a top-selling item (such as AirPods) simultaneously holds a rank in its parent department (`#4` in `Electronics`) and a rank in its leaf subcategory (`#1` in `Headphones & Earbuds`). Because `rowKey` includes `categorySlug` (`<domain>:<chartType>:<categorySlug>:<asin>`), both distinct chart rankings are preserved accurately without duplicating rows inside the same category.

#### Can I export ranked products directly to Excel, CSV, Google Sheets or Parquet?

Yes. Every field on `product` rows is flat (`rank`, `asin`, `title`, `price`, `priceFormatted`, `currency`, `rating`, `reviewsCount`, `offersCount`, `categoryName`, `chartType`, `domain`, `productUrl`, `imageUrl`, `highResImageUrl`), so datasets export cleanly to CSV, Excel (`.xlsx`), JSON or Parquet from the Apify Console or Dataset API with zero nested JSON flattening needed.

#### What happens if Apify restarts my container mid-batch?

At startup, the Actor reads all deterministic `rowKey` identifiers (`<domain>:<chartType>:<categorySlug>:<asin>`) already written to the current run's default Dataset before beginning network requests. Any ranked product already delivered prior to a server migration or restart is skipped automatically, guaranteeing zero duplicate rows and zero duplicate per-event charges even on large multi-country subcategory sweeps.

### 🐛 Troubleshooting

- **Dataset contains only a `rowType: "status"` row with `"EMPTY_INPUT"`:** Both `categories` and `categoryUrls` were empty. Add at least one department slug or Amazon chart URL.
- **`INVALID_URL` status row on a `categoryUrls` entry:** `categoryUrls` expects Amazon leaderboard URLs (`/zgbs/`, `/gp/bestsellers/`, or `/gp/new-releases/`), not search URLs (`/s?k=...`) or individual `/dp/` product pages.
- **Category returned fewer than 100 items (e.g. 42 items):** Very small or newly created leaf subcategories on smaller regional Amazon domains sometimes contain fewer than 100 qualifying ranked products.
- **Default `"electronics"` ran alongside your `categoryUrls`:** Clear `categories` in the Console UI or pass `"categories": []` in your JSON payload when you only want `categoryUrls`.

### 🚧 What It Does Not Do

- Does **not** scrape keyword search results (`/s?k=…`), Seller Central private inventory counts, or individual customer review text (enable `enrichProductDetails: true` when you want `/dp/<ASIN>` brand, seller, bullet points, specs, and BSR sub-ranks on ranked products).
- Does **not** estimate monthly unit sales volume (only official public Amazon chart `rank`, `price`, `rating` and `reviewsCount` are reported — zero guesswork).

### ⚠️ Trademark Notice

This Actor is an independent data-collection tool developed by **foXLabs** and is not affiliated with, endorsed by, or sponsored by Amazon.com, Inc. or its affiliates. "Amazon" and "Kindle" are trademarks of Amazon.com, Inc., referenced strictly to describe compatibility with publicly accessible marketplace chart pages.

### ⚖️ Is It Legal to Scrape Public Amazon Best Sellers Charts?

This Actor reads only publicly visible product leaderboard pages (`rank`, `asin`, `title`, public list price and aggregate star rating) served to any unauthenticated visitor — with zero account login and zero personal customer data collected. Always use extracted market data responsibly and in compliance with applicable laws.

### 🤝 Support, Custom Data & Contact

- 🌐 **Website & full portfolio:** [data.foxlabs.com.tr](https://data.foxlabs.com.tr)
- 📧 **Custom data & enterprise inquiries:** info@foxlabs.com.tr
- 🐛 **Bug reports & feature requests:** open an issue in the Actor's **Issues** tab on Apify Store (include your Run ID)
- 🧰 **Browse all foXLabs Actors:** [apify.com/foxlabs](https://apify.com/foxlabs)

### Changelog

#### 0.1.3 (2026-11-14)

- Added optional `enrichProductDetails` (`boolean`, default `false`) to enrich ranked ASINs with 17 deep `/dp/<ASIN>` product fields (`brand`, `manufacturer`, `sellerName`, `isPrime`, `availability`, `listPrice`, `discountPct`, `bulletPoints`, `description`, `bsrRanks`, `dimensions`, `itemWeight`, `modelNumber`, `dateFirstAvailable`, `galleryImageUrls`, `categoriesBreadcrumb`, `detailsEnriched`) at zero extra PPE event charge.

#### 0.1.2 (2026-11-14)

- Upgraded Store README to full SIÁN standard with MCP & x402 AI agent setup, Standby HTTP `POST /scrape` examples, measured platform QA & D+0 billing benchmarks, worked PPE cost breakdowns, and expanded 12-question FAQ.

#### 0.1.0 (2026-11-13)

- Initial release of `foxlabs/amazon-bestsellers-scraper` supporting `#1–#100` gap-free Best Sellers and Hot New Releases extraction across 10 Amazon marketplaces, subcategory discovery, PPE `product` billing, and Batch + Standby HTTP modes.

# Changelog

This Actor's version history is a separate document: https://apify.com/foxlabs/amazon-bestsellers-scraper/changelog.md

# Actor input Schema

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

Amazon department slugs to scrape on the selected marketplace domain (e.g. 'electronics', 'books', 'beauty', 'kitchen', 'toys-and-games', 'computers', 'sports-and-outdoors', 'pet-supplies', 'office-products', 'video-games', 'automotive', 'baby-products', 'software').

## `categoryUrls` (type: `array`):

Optional full Amazon Best Sellers (/zgbs/... or /gp/bestsellers/...) or Hot New Releases (/gp/new-releases/...) URLs from any supported Amazon marketplace.

## `domain` (type: `string`):

Marketplace domain used when scraping `categories` slugs.

## `chartType` (type: `string`):

Scrape Best Sellers, Hot New Releases, or both charts for every category slug.

## `maxItemsPerCategory` (type: `integer`):

Maximum ranked items per category chart (1 to 100). Fetches SSR ranks #1-#30, ACP widget ranks #31-#50, and Page 2 ranks #51-#100 as needed.

## `crawlSubcategories` (type: `boolean`):

When true, automatically discovers and scrapes child subcategories linked in the category sidebar (capped by maxSubcategories).

## `maxSubcategories` (type: `integer`):

Maximum child subcategories to scrape per parent category when crawlSubcategories is enabled.

## `enrichProductDetails` (type: `boolean`):

When enabled, fetches each ranked product's /dp/<ASIN> detail page to extract brand, manufacturer, Buy Box seller, Prime status, stock availability, list price, discount %, bullet points, description, BSR sub-ranks, dimensions, weight, model number, date first available, full image gallery, and category breadcrumbs at no extra event fee.

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

Apify Proxy settings. Defaults to automatic proxy selection (zero user keys or cookies required).

## Actor input object example

```json
{
  "categories": [
    "electronics"
  ],
  "categoryUrls": [],
  "domain": "amazon.com",
  "chartType": "bestsellers",
  "maxItemsPerCategory": 50,
  "crawlSubcategories": false,
  "maxSubcategories": 3,
  "enrichProductDetails": false,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

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

No description

## `sourceReport` (type: `string`):

No description

# 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"
    ],
    "maxItemsPerCategory": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("foxlabs/amazon-bestsellers-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"],
    "maxItemsPerCategory": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("foxlabs/amazon-bestsellers-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"
  ],
  "maxItemsPerCategory": 50
}' |
apify call foxlabs/amazon-bestsellers-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,foxlabs/amazon-bestsellers-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/890JYHmY7lCcWmnbe/builds/sh6GVttC8faogP9aN/openapi.json
