# Amazon Best Sellers & Seller UBO Scraper (`scrapers_lat/amazon-bestsellers-seller-scraper`) Actor

Track Amazon Best Sellers rank/ASIN/price/rating by category, plus seller profiles with business name, registered address (UBO), country, VAT and feedback. HTTP, JSON/CSV/Excel.

- **URL**: https://apify.com/scrapers\_lat/amazon-bestsellers-seller-scraper.md
- **Developed by:** [Scrapers Lat](https://apify.com/scrapers_lat) (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 $8.32 / 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.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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 Best Sellers & Seller UBO Scraper](https://scrapers.lat/banners/amazon-bestsellers-seller-scraper.png)](https://console.apify.com/actors/RVs2yVxwRvMMejFf0/input)

## Amazon Best Sellers & Seller UBO Scraper

Here is one real seller-profile result, with every field the actor returns in seller mode:

```json
{
  "mode": "seller",
  "sellerId": "A1S39RKFZC1S5T",
  "sellerName": "HEVO Store",
  "businessName": "HEVO TECHNOLOGY CORPORATION",
  "businessAddress": "4 Executive Circle, Suite 120, IRVINE, CA, 92614, US",
  "businessAddressLines": [
    "4 Executive Circle, Suite 120",
    "IRVINE",
    "CA",
    "92614",
    "US"
  ],
  "country": "US",
  "tradeRegisterNumber": null,
  "vatNumber": null,
  "phoneNumber": null,
  "customerServiceAddress": null,
  "feedbackPositivePct": 98,
  "feedbackRatingsLifetime": 118,
  "sellerRating": 5,
  "hasBusinessInfo": true,
  "sellerUrl": "https://www.amazon.com/sp?seller=A1S39RKFZC1S5T",
  "domain": "com",
  "aiSummary": null,
  "error": null
}
```

The most complete Amazon Best-Sellers and seller-identity scraper available. It tracks live Best-Sellers rank, ASIN, title, price and rating for any category, and it resolves the legal business identity behind a listing from the "Detailed Seller Information" page (legal business name, registered address, country, feedback), a sub-target most Amazon scrapers skip. It works across 15 marketplaces and gives you six filters plus opt-in add-ons.

**📥 [Input](https://apify.com/scrapers_lat/amazon-bestsellers-seller-scraper/input-schema) · 📤 [Output](https://apify.com/scrapers_lat/amazon-bestsellers-seller-scraper/output-schema) · 💰 [Pricing](https://apify.com/scrapers_lat/amazon-bestsellers-seller-scraper/pricing) · ▶️ [Examples](https://apify.com/scrapers_lat/amazon-bestsellers-seller-scraper/examples)**

![Apify](https://img.shields.io/badge/Platform-Apify-1CE1CE?logo=apify\&logoColor=white)
![Coverage](https://img.shields.io/badge/Coverage-15%20marketplaces-blue)
![Output](https://img.shields.io/badge/Output-JSON%20%7C%20CSV%20%7C%20Excel-orange)
![Billing](https://img.shields.io/badge/Billing-Pay%20per%20result-brightgreen)

### Table of contents

- [What it does](#what-it-does)
- [Quickstart](#quickstart)
- [Input reference](#input-reference)
- [Output reference](#output-reference)
- [Example output record](#example-output-record)
- [Run via API and CLI](#run-via-api-and-cli)
- [Fetch results](#fetch-results)
- [Billing and limits](#billing-and-limits)
- [FAQ and troubleshooting](#faq-and-troubleshooting)

### What it does

The actor runs in two modes:

- **Best-Sellers** (`mode: "bestsellers"`): reads an Amazon Best-Sellers list for a category (`/gp/bestsellers/<category>`) and returns one record per ranked product: rank, ASIN, title, price, currency, star rating, ratings count, image and product URL. Turn on `withDetails` to fetch each product page and add the Buy Box seller, its seller ID, the best-seller rank detail line and the feature bullets.
- **Seller** (`mode: "seller"`): takes seller IDs or seller URLs and returns the seller's profile from the storefront and "Detailed Seller Information" page: display name, legal business name, registered business address (broken into lines), country, trade register / VAT number when shown, feedback percentage, lifetime ratings count and seller rating.

The seller business identity (the UBO angle) can also be attached to Best-Sellers items: enable the `seller_ubo` add-on and every item's Buy Box seller is resolved to its legal business name and registered address.

Supported marketplaces: `com`, `co.uk`, `de`, `es`, `fr`, `it`, `ca`, `com.mx`, `com.br`, `com.au`, `co.jp`, `in`, `nl`, `se`, `pl`.

### Quickstart

Open the actor, paste this into the input, and press Run. It returns the top 20 Electronics best-sellers with Buy Box seller details.

```json
{
  "mode": "bestsellers",
  "category": "electronics",
  "domain": "com",
  "maxItems": 20,
  "withDetails": true
}
```

To pull the business identity behind specific sellers:

```json
{
  "mode": "seller",
  "sellerIds": ["A1S39RKFZC1S5T", "A2YNUEXBGH2YRR"],
  "domain": "com",
  "withSellerUbo": true
}
```

### Input reference

| Name | Type | Required | Description | Example |
| --- | --- | --- | --- | --- |
| `mode` | string | no | `bestsellers` (ranked list) or `seller` (seller profiles / UBO). | `"bestsellers"` |
| `category` | string | no | Best-Sellers category slug, node or full URL. Empty = top-level list. | `"electronics"` |
| `categoryUrls` | array | no | One or more full `/gp/bestsellers/...` URLs. | `["https://www.amazon.com/gp/bestsellers/books"]` |
| `sellerIds` | array | no | Amazon seller/merchant IDs (seller mode). | `["A1S39RKFZC1S5T"]` |
| `sellerUrls` | array | no | Seller URLs containing `seller=<id>` (seller mode). | `["https://www.amazon.com/sp?seller=A1S39RKFZC1S5T"]` |
| `domain` | string | no | Marketplace domain. Default `com`. | `"co.uk"` |
| `maxItems` | integer | no | Max records. Free plans capped at 10. Default 50. | `20` |
| `withDetails` | boolean | no | Bestsellers: fetch each product page for Buy Box seller, seller ID, rank detail and features. Default true. | `true` |
| `withSellerUbo` | boolean | no | Resolve the seller's business name and registered address (UBO). Default on in seller mode. Paid plans only. | `true` |
| `withSummary` | boolean | no | AI one-line KYB summary of a seller. Paid plans only. | `false` |
| `withAttributes` | boolean | no | AI structured product attributes and category (bestsellers). Paid plans only. | `false` |
| `minRating` | integer | no | Keep best-seller items at or above this star rating (0-5). | `4` |
| `maxRank` | integer | no | Keep best-seller items at or below this rank. | `20` |

### Output reference

| Name | Type | Description |
| --- | --- | --- |
| `mode` | string | `bestsellers` or `seller`. |
| `category` | string | Category name (bestsellers mode). |
| `rank` | integer | Best-Sellers rank position. |
| `asin` | string | Product ASIN. |
| `title` | string | Product title. |
| `price` | number | Price in the marketplace currency. |
| `currency` | string | ISO currency code. |
| `rating` | number | Star rating (0-5). |
| `ratingsCount` | integer | Number of ratings. |
| `productUrl` | string | Canonical product URL. |
| `imageUrl` | string | Primary product image. |
| `domain` | string | Marketplace domain. |
| `buyBoxSeller` | string | Buy Box seller display name (details add-on). |
| `buyBoxSellerId` | string | Buy Box seller ID (details add-on). |
| `shipsFrom` | string | Ships-from entity when shown. |
| `bestSellerRankDetail` | string | Best-seller rank line from the product page. |
| `reviewsCount` | integer | Review count from the product page. |
| `features` | array | Feature bullet points (details add-on). |
| `sellerId` | string | Amazon seller/merchant ID. |
| `sellerName` | string | Seller storefront display name. |
| `businessName` | string | Legal business name (Detailed Seller Information). |
| `businessAddress` | string | Registered business address (UBO), joined. |
| `businessAddressLines` | array | Registered address split into lines. |
| `country` | string | Registered country (ISO code). |
| `tradeRegisterNumber` | string | Trade register number when shown. |
| `vatNumber` | string | VAT number when shown. |
| `phoneNumber` | string | Seller phone number when shown. |
| `customerServiceAddress` | string | Customer service address when shown. |
| `feedbackPositivePct` | number | Positive feedback percentage. |
| `feedbackRatingsLifetime` | integer | Lifetime rating count. |
| `sellerRating` | number | Seller star rating. |
| `hasBusinessInfo` | boolean | True when a legal business name or address was found. |
| `sellerUrl` | string | Seller profile URL. |
| `aiSummary` | string | AI KYB summary (add-on). |
| `aiAttributes` | object | AI structured attributes (add-on). |
| `aiCategory` | string | AI category (add-on). |
| `error` | string | Error reason, or null. |

### Example output record

A real Best-Sellers item (rank 1 in Musical Instruments, with the `withDetails` add-on):

```json
{
  "mode": "bestsellers",
  "category": "musical instruments",
  "rank": 1,
  "asin": "B0CMJTSVRW",
  "title": "Mini Mic Pro (Latest Model, #1 Microphone for iPhone & Android, Wireless Mini Microphone, Clear Voice, Noise Cancelling, Lavalier Mic for TikTok, YouTube & Interviews",
  "price": 24.99,
  "currency": "USD",
  "rating": 4.3,
  "ratingsCount": 7495,
  "productUrl": "https://www.amazon.com/dp/B0CMJTSVRW",
  "imageUrl": "https://images-na.ssl-images-amazon.com/images/I/711s6fypzWL.jpg",
  "domain": "com",
  "buyBoxSeller": "Designed in NYC",
  "buyBoxSellerId": "ACJX9YJUXSVOZ",
  "bestSellerRankDetail": "#1 in Musical Instruments",
  "features": [
    "The Original Mini Microphone: studio-quality sound in a design small enough to clip onto your shirt.",
    "Seamless Connection: works with iPhone, Android, tablet or laptop, USB-C and Lightning adapters included.",
    "Rechargeable Battery: record for up to 6 hours per charge."
  ],
  "error": null
}
```

### Run via API and CLI

Start a run with the Apify API:

```bash
curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~amazon-bestsellers-seller-scraper/runs?token=YOUR_TOKEN" \
  -H "content-type: application/json" \
  -d '{ "mode": "bestsellers", "category": "electronics", "domain": "com", "maxItems": 20, "withDetails": true }'
```

Or with the Apify CLI:

```bash
apify call scrapers_lat/amazon-bestsellers-seller-scraper \
  --input='{ "mode": "seller", "sellerIds": ["A1S39RKFZC1S5T"], "withSellerUbo": true }'
```

### Fetch results

Read the dataset items from a finished run:

```bash
curl "https://api.apify.com/v2/datasets/DATASET_ID/items?token=YOUR_TOKEN&clean=true&format=json"
```

Swap `format=json` for `csv` or `xlsx` to download other formats.

### Billing and limits

This actor is billed pay per result (pay-per-event):

| Event | When it is charged |
| --- | --- |
| `result` | One dataset record (a Best-Sellers item or a seller profile). |
| `details` | A Best-Sellers item enriched from its product page (Buy Box seller, rank detail, features). |
| `seller_ubo` | A seller resolved to a legal business name / registered address. Charged only when business info is found. |
| `ai_attributes` | AI product attributes, charged only on usable AI output. |
| `ai_summary` | AI seller KYB summary, charged only on usable AI output. |

- Failed records are never charged. If a product or seller page cannot be reached, the row carries an `error` and no billable add-on fires.
- Free Apify plans are capped at 10 records per run, and the paid add-ons (`seller_ubo`, `ai_attributes`, `ai_summary`) are disabled for free plans.
- Set a run spend limit (`maxTotalChargeUsd`) and the actor stops emitting billable results once it is reached.

### FAQ and troubleshooting

**Which sellers expose a business name and address?** Professional third-party sellers list their legal business name and registered address on the "Detailed Seller Information" page. Amazon's own first-party listings and some brand-registered sellers do not, so those records return `hasBusinessInfo: false`.

**Where do I get a seller ID?** Run bestsellers mode with `withDetails: true` and read `buyBoxSellerId`, or copy the `seller=` value from any seller URL. You can feed those straight into seller mode.

**How many best-sellers per category?** Amazon publishes up to 100 ranked products per Best-Sellers list (two pages of 50). Use `maxRank` to keep only the top N.

**Why is a field null?** The source did not show that value for that record. Missing values are returned as `null` rather than dropped, so the row shape stays consistent.

### More scrapers at scrapers.lat

- [Amazon Product Price & Reviews Scraper](https://apify.com/scrapers_lat/amazon-product-scraper)
- [Amazon Reviews Scraper](https://apify.com/scrapers_lat/amazon-reviews-scraper)

# Actor input Schema

## `mode` (type: `string`):

What to scrape: 'bestsellers' returns a ranked Best-Sellers list for a category; 'seller' returns seller profiles with business name and registered address (UBO) for the seller IDs you provide.

## `category` (type: `string`):

Best-Sellers category node or slug, e.g. 'electronics', 'books', 'electronics/172282' or a full /gp/bestsellers URL. Leave empty for the top-level Best Sellers list. Used in bestsellers mode.

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

One or more full Best-Sellers page URLs (https://www.amazon.com/gp/bestsellers/...). Alternative to 'category'. Used in bestsellers mode.

## `sellerIds` (type: `array`):

Amazon seller/merchant IDs (e.g. A2L77EE7U53NWQ). Used in seller mode.

## `sellerUrls` (type: `array`):

Seller storefront/profile URLs containing seller=<id> (e.g. https://www.amazon.com/sp?seller=...). Used in seller mode.

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

Amazon marketplace to scrape.

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

Maximum number of records to return. Free Apify plans are capped at 10 per run.

## `withDetails` (type: `boolean`):

Bestsellers mode: fetch each item's product page for the Buy Box seller, seller ID, best-seller rank detail and feature bullets. Charged as the 'details' add-on only when detail data is returned.

## `withSellerUbo` (type: `boolean`):

Fetch the seller's Detailed Seller Information page and add business name, registered address (UBO), country, VAT and feedback. Default ON in seller mode. Requires a paid Apify plan. Charged as 'seller\_ubo' only when business info is found.

## `withSummary` (type: `boolean`):

AI one-line KYB summary of the seller (who they are, where based, trust signal). Requires a paid Apify plan. Charged as 'ai\_summary' only on usable AI output.

## `withAttributes` (type: `boolean`):

Bestsellers mode: AI-extracted structured product attributes and a broad category. Requires a paid Apify plan. Charged as 'ai\_attributes' only on usable AI output.

## `minRating` (type: `integer`):

Only keep best-seller items with a star rating at or above this value (0-5). Items without a rating are kept.

## `maxRank` (type: `integer`):

Only keep best-seller items with rank at or below this value (e.g. 20 = top 20).

## Actor input object example

```json
{
  "mode": "bestsellers",
  "category": "electronics",
  "domain": "com",
  "maxItems": 50,
  "withDetails": true,
  "withSellerUbo": false,
  "withSummary": false,
  "withAttributes": false
}
```

# Actor output Schema

## `results` (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 = {
    "category": "electronics"
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapers_lat/amazon-bestsellers-seller-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 = { "category": "electronics" }

# Run the Actor and wait for it to finish
run = client.actor("scrapers_lat/amazon-bestsellers-seller-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 '{
  "category": "electronics"
}' |
apify call scrapers_lat/amazon-bestsellers-seller-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapers_lat/amazon-bestsellers-seller-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/RVs2yVxwRvMMejFf0/builds/0hEuZASGqfoycEMvk/openapi.json