# Amazon Third-Party Seller Discovery & Lead Finder (`xyrelith-data/amazon-seller-discovery-leads`) Actor

Find third-party Amazon sellers behind keywords, categories, best-seller lists, brands or ASINs. Each seller row carries the published business name, address, country, VAT/registration, phone and email where shown, ratings over 30 days to lifetime, offer and FBA context, and optional buyer feedback.

- **URL**: https://apify.com/xyrelith-data/amazon-seller-discovery-leads.md
- **Developed by:** [Xyrelith Data](https://apify.com/xyrelith-data) (community)
- **Categories:** E-commerce, Lead generation, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.49 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
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 Third-Party Seller Discovery & Lead Finder

Turn a product niche into a list of the **companies selling in it**. Give the actor a keyword, a
category, a Best Sellers page, a brand or a handful of ASINs, and it walks the products, reads every
visible offer, and returns **one row per third-party seller**: the storefront identity, the business
name and address Amazon publishes, VAT/registration/phone/email where the marketplace shows them,
ratings over four time windows, and the offer, price and fulfillment context that tells you how big
the lead is.

No Amazon account, cookies or API key. Every run reads live public pages.

### What it does

1. **Finds products** from your chosen discovery mode (keyword, category, Best Sellers, brand or
   ASIN), paging the source until your product limit.
2. **Reads the offers** behind each product — the featured offer plus the other merchants Amazon
   lists — and collects each seller's offer price, condition and FBA/FBM fulfillment.
3. **Reads each seller's public profile**, including the "Detailed Seller Information" block that EU
   sellers must publish and the business name/address shown for US sellers.
4. **Deduplicates and filters** to one row per seller per marketplace, then applies your country,
   rating and fulfillment filters.
5. Optionally attaches each seller's **newest buyer feedback** (text, stars, date, rater, seller
   reply) by paging Amazon's feedback endpoint.

### Discovery modes

| Mode | Input | Example |
|---|---|---|
| Keyword search | Keywords | `wireless charger` |
| Category / browse node | Category or node URLs, or a bare node ID | `https://www.amazon.com/b?node=172282`, `172282` |
| Best Sellers list | Best Sellers or `/zgbs/` URLs | `https://www.amazon.com/gp/bestsellers/electronics/` |
| Brand search | Brand names or brand-store URLs | `Anker` |
| ASIN list | ASINs or product URLs | `B08N5WRWNW` |

`marketplaces` selects the Amazon stores. Bare keywords, brands and ASINs run on every selected
store; a pasted URL always keeps its own store. Supported: United States, United Kingdom, Germany,
France, Italy, Spain, Canada, Japan, India and Australia.

### Inputs

| Field | What it does |
|---|---|
| `mode` | Which discovery path to use. |
| `keywords`, `categoryUrls`, `bestSellerUrls`, `brands`, `asins` | Inputs for the matching mode. |
| `marketplaces` | Stores to scan (multi-select). |
| `maxProducts` | Products inspected per input. |
| `maxSellers` | Hard cap on seller rows across the run. |
| `maxOfferPages` | Offer-list pages read per product (10 offers per page). |
| `includeAllOffers` | Page each product's offers until Amazon's reported total. |
| `businessCountries` | Keep only sellers registered in these countries. |
| `excludeBusinessCountries` | Drop sellers registered in these countries. |
| `minLifetimeRatings` | Drop sellers below this lifetime rating count. |
| `minPositivePercent` | Drop sellers below this 12-month positive share. |
| `fulfillment` | Keep sellers with at least one FBA or FBM offer. |
| `excludeAmazonRetail` | Skip Amazon's own retail accounts (on by default). |
| `includeFeedback` | Attach each seller's newest buyer feedback. |
| `maxFeedbackPerSeller` | Cap on feedback entries per seller. |
| `proxyConfiguration` | Optional proxy override. The actor works without any proxy setup. |

#### Try it

```json
{
  "mode": "keyword",
  "keywords": ["wireless charger"],
  "marketplaces": ["amazon.com"],
  "maxProducts": 10,
  "maxSellers": 20
}
```

A seller-country filter for a European niche:

```json
{
  "mode": "category",
  "categoryUrls": ["https://www.amazon.de/b?node=340852031"],
  "marketplaces": ["amazon.de"],
  "businessCountries": ["DE", "AT"],
  "minLifetimeRatings": 50,
  "maxSellers": 50
}
```

### Inputs and defaults

| Field | Default | What it does |
|---|---|---|
| `mode` | `keyword` | Discovery path: keyword, category, bestsellers, brand or asins. |
| `keywords` | `[]` | Keywords for keyword mode. |
| `categoryUrls` | `[]` | Category pages, browse-node URLs or bare node IDs. |
| `bestSellerUrls` | `[]` | Best Sellers pages or category slugs. |
| `brands` | `[]` | Brand names or brand-store URLs. |
| `asins` | `[]` | ASINs or product URLs. |
| `marketplaces` | `["amazon.com"]` | Stores to scan. |
| `maxProducts` | `10` | Products inspected per input. |
| `maxSellers` | `50` | Seller rows emitted across the run. |
| `maxOfferPages` | `2` | Offer-list pages read per product. |
| `includeAllOffers` | `false` | Page each product's offers to Amazon's reported total. |
| `businessCountries` | `[]` | Keep only these registered seller countries. |
| `excludeBusinessCountries` | `[]` | Drop these registered seller countries. |
| `minLifetimeRatings` | `0` | Minimum lifetime rating count. |
| `minPositivePercent` | `0` | Minimum 12-month positive share. |
| `fulfillment` | `ANY` | Any, FBA-only or FBM-only leads. |
| `excludeAmazonRetail` | `true` | Skip Amazon's own retail accounts. |
| `includeFeedback` | `false` | Attach the newest buyer feedback per seller. |
| `maxFeedbackPerSeller` | `10` | Feedback entries per seller (0-1,000). |
| `proxyConfiguration` | none | Optional Apify Proxy override. |

### Output

One `seller` row per unique seller per marketplace, plus one `summary` row per run. Empty fields are
omitted rather than set to null.

| Group | Fields |
|---|---|
| Identity | `sellerId`, `sellerName`, `marketplace`, `marketplaceId`, `sellerProfileUrl`, `storefrontUrl`, `contactUrl`, `logoUrl` |
| Business identity | `businessName`, `businessType`, `businessAddress`, `businessAddressLines`, `businessPostalCode`, `businessCountry`, `businessRegistrationNumber`, `businessVatNumber`, `businessTaxId`, `businessPhone`, `businessEmail`, `businessFax`, `customerServiceAddress`, `businessDetails`, `isBusinessSeller` |
| Ratings | `positiveRatingPercent`, `positiveRatingCount`, `positiveRatingPeriodMonths`, `feedbackRating`, `ratingCountLastMonth`, `ratingCountLast3Months`, `ratingCountLast12Months`, `ratingCountLifetime`, `ratingLastMonth`, `ratingLast3Months`, `ratingLast12Months`, `ratingLifetime`, `ratingHistogram` |
| Offer context | `offerCount`, `fbaOfferCount`, `fbmOfferCount`, `fbaSharePercent`, `minOfferPrice`, `maxOfferPrice`, `priceCurrency`, `offerConditions`, `featuredOfferCount` |
| Discovery trace | `discoveredAsins` (ASIN, title, URL, price, featured offer, source, query), `discoverySources`, `discoveryQueries`, `sourceUrl` |
| Feedback (optional) | `feedback` (rating, text, date, rater, suppressed flag/reason, seller reply), `feedbackComplete` |
| About | `aboutSeller`, `memberSince`, `scrapedAt` |

#### Example row (trimmed)

```json
{
  "sellerId": "A1NUD6LVRJ5MT7",
  "sellerName": "more-than-words",
  "marketplace": "amazon.com",
  "businessName": "Example Books LLC",
  "businessAddress": "2881 Industrial Ave Unit D, Hubbard, OR, 97032, US",
  "businessCountry": "US",
  "positiveRatingPercent": 90,
  "ratingCountLifetime": 66223,
  "ratingLast12Months": 4.5,
  "offerCount": 1,
  "fbmOfferCount": 1,
  "fbaSharePercent": 0.0,
  "minOfferPrice": 1.36,
  "priceCurrency": "USD",
  "discoveredAsins": [{"asin": "059035342X", "price": 1.36, "source": "bestsellers"}],
  "recordType": "seller"
}
```

### How seller discovery works

- **Keyword and category** pages are paged until the product limit. Listings expose product cards;
  category pages that omit the card marker fall back to product links.
- **Best Sellers** pages embed Amazon's top-100 ranking in the page itself, so no browser is needed.
- **Offers**: each product's All Offers Display is fetched page by page (10 offers per page). A
  product page fallback supplies the featured seller when the offer list is not available.
- **Seller profiles** are the public `/sp?seller=` pages. The "Detailed Seller Information" block is
  parsed label by label, so fields a marketplace adds later still land in `businessDetails`.

### Which marketplaces show which business fields

- **EU and UK** stores publish the legally required business identity: legal name, business type,
  trade-register number, VAT number, phone, email and full address (and often a separate customer
  service address).
- **US** profiles carry the business name and address under the INFORM Consumers Act, but not email
  or phone.
- **Canada, Australia and India** profiles often omit the business block entirely; those rows still
  carry ratings, storefront and offer context.

All fields are omitted when Amazon does not show them. The actor never guesses or enriches from
third-party sources.

### Notes and limits

- **One row per seller per marketplace.** The same company can appear on several stores with
  different ratings and business details.
- **Offers shown depend on the visitor's location.** The actor reads the offers Amazon serves to its
  connection; a postcode change is not available on Amazon's mobile layout, so a store can show
  fewer local offers than a shopper in that country sees.
- **Amazon's anti-bot layer is uneven across stores and hours.** Listing and offer pages are retried
  over several connections and, on a store that refuses datacenter traffic, a browser session. A
  marketplace that still refuses the request is reported in the run summary as blocked and does not
  stop the other marketplaces.
- **Amazon's own retail accounts** are skipped by default. Turn `excludeAmazonRetail` off to keep
  them.
- **Feedback** is fetched 5 rows per request and capped by `maxFeedbackPerSeller`.
- **Sellers with no published business address** are skipped when a country filter is set; without a
  country filter they are kept.
- **Best Sellers** lists are capped by Amazon at the top 100 products per list.
- Off-Amazon email discovery, storefront catalogue sizes and delivery-postcode changes are outside
  this actor's scope. Off-Amazon identity guessing is deliberately not used: every contact field
  comes from Amazon's own seller page.

### FAQ

**Do I need an Amazon account, cookie or API key?**
No. The actor reads public listing, offer and seller-profile pages, and it picks a working connection
automatically when Amazon refuses one. No proxy setup is needed.

**Can I get emails and phone numbers?**
On EU and UK stores, yes — Amazon requires business sellers to publish them. On amazon.com the
profile normally shows only the business name and address, so email and phone are absent unless the
seller publishes them.

**How do I find sellers from my own product?**
Put the ASIN or product URL in `asins`. The actor reads every offer page for the product (up to
`maxOfferPages`, or all of them with `includeAllOffers`) and returns each merchant once.

**How many sellers can one run return?**
There is no source-wide cap; `maxSellers` (up to 1,000) is the hard limit. Wide niches need more
`maxProducts` so the offer walk reaches enough sellers.

**Why is a seller row missing its rating?**
New sellers, and some stores' sellers, have no rating summary. Rating fields are omitted; the rest
of the row is still returned.

**Are the results live?**
Yes. Every run reads Amazon at run time. Schedule the actor weekly to follow rating and offer
changes.

### Data source

Public Amazon marketplace pages: search and category listings, Best Sellers rankings, product offer
lists and seller profiles. Only information Amazon shows to any anonymous visitor is collected.

# Actor input Schema

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

How seller leads are discovered. Keyword search, category page, best-seller list, brand search or a list of ASINs. Every mode walks the products found and reads the sellers behind their offers.

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

Product keywords to search on each selected marketplace. Each search is paged until the product limit is reached, then the offers behind every product are read and their sellers collected.

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

Amazon category pages or browse nodes, for example https://www.amazon.com/b?node=172282, https://www.amazon.com/s?rh=n%3A172282 or just 172282. A URL keeps its own marketplace.

## `bestSellerUrls` (type: `array`):

Amazon Best Sellers pages, for example https://www.amazon.com/gp/bestsellers/electronics/ or an /zgbs/ path. The page's top-100 product ranking is read without a browser.

## `brands` (type: `array`):

Brand names to search for, or Amazon brand-store URLs. A bare brand runs on every selected marketplace.

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

Product ASINs or product URLs whose every visible offer should be scanned. A URL keeps its own marketplace; a bare ASIN runs on the selected marketplaces.

## `marketplaces` (type: `array`):

Amazon stores to scan. Bare keywords, brands and ASINs run on every selected store; a pasted URL uses the store in the URL. EU stores publish the full legally required business identity (VAT, register number, phone, email).

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

How many product listings to inspect for each keyword, category, best-seller list, brand or ASIN input. Each product's offer list yields the sellers behind it.

## `maxSellers` (type: `integer`):

Hard cap on unique seller rows emitted across the whole run, after filters. The actor keeps reading products until this many sellers pass or the inputs are exhausted.

## `maxOfferPages` (type: `integer`):

How many pages of a product's All Offers Display to read. Each page holds up to 10 offers with their seller IDs. Two pages cover the featured offer plus 19 more.

## `includeAllOffers` (type: `boolean`):

When on, each product's offer list is paged until Amazon's own reported offer count is reached, instead of stopping at the offer-page limit. Slower but finds the deepest-tail resellers.

## `businessCountries` (type: `array`):

Keep only sellers whose published business address ends in one of these two-letter country codes, for example DE, GB or US. Leave empty to keep every country. A seller with no business address on Amazon is skipped when this filter is set.

## `excludeBusinessCountries` (type: `array`):

Drop sellers whose published business address ends in one of these two-letter country codes, for example CN or HK. Many China-based sellers trade through a Hong Kong company, so list both to leave them out.

## `minLifetimeRatings` (type: `integer`):

Drop sellers below this lifetime rating count. Sellers Amazon shows no rating count for pass through.

## `minPositivePercent` (type: `integer`):

Drop sellers below this share of positive ratings in the last 12 months, from 0 to 100. Sellers without a rating summary pass through.

## `fulfillment` (type: `string`):

Keep only sellers with at least one discovered offer fulfilled by Amazon (FBA) or shipped by the merchant (FBM). ANY keeps everyone.

## `excludeAmazonRetail` (type: `boolean`):

Skip offers sold by Amazon itself (Amazon.com, Amazon US, Amazon EU, Amazon Resale and similar) so every row is a third-party seller. Recommended on.

## `includeFeedback` (type: `boolean`):

Attach each seller's newest individual buyer feedback (stars, text, date, rater, whether Amazon struck it, seller reply) by paging Amazon's feedback endpoint. Adds one or more requests per seller.

## `maxFeedbackPerSeller` (type: `integer`):

How many of the seller's newest feedback entries to attach when buyer feedback is on. Amazon serves 5 rows per request.

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

Optional Apify Proxy override. The actor works with no setup and picks a working connection automatically when Amazon blocks a request.

## Actor input object example

```json
{
  "mode": "keyword",
  "keywords": [
    "wireless charger",
    "phone case"
  ],
  "categoryUrls": [],
  "bestSellerUrls": [],
  "brands": [],
  "asins": [],
  "marketplaces": [
    "amazon.com"
  ],
  "maxProducts": 2,
  "maxSellers": 1,
  "maxOfferPages": 1,
  "includeAllOffers": false,
  "businessCountries": [],
  "excludeBusinessCountries": [],
  "minLifetimeRatings": 0,
  "minPositivePercent": 0,
  "fulfillment": "ANY",
  "excludeAmazonRetail": true,
  "includeFeedback": false,
  "maxFeedbackPerSeller": 0
}
```

# Actor output Schema

## `sellers` (type: `string`):

Dataset containing one record per discovered seller plus one summary record per run.

# 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 = {
    "mode": "keyword",
    "keywords": [
        "wireless charger"
    ],
    "categoryUrls": [],
    "bestSellerUrls": [],
    "brands": [],
    "asins": [],
    "marketplaces": [
        "amazon.com"
    ],
    "maxProducts": 2,
    "maxSellers": 1,
    "maxOfferPages": 1,
    "includeAllOffers": false,
    "businessCountries": [],
    "excludeBusinessCountries": [],
    "minLifetimeRatings": 0,
    "minPositivePercent": 0,
    "fulfillment": "ANY",
    "excludeAmazonRetail": true,
    "includeFeedback": false,
    "maxFeedbackPerSeller": 0
};

// Run the Actor and wait for it to finish
const run = await client.actor("xyrelith-data/amazon-seller-discovery-leads").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 = {
    "mode": "keyword",
    "keywords": ["wireless charger"],
    "categoryUrls": [],
    "bestSellerUrls": [],
    "brands": [],
    "asins": [],
    "marketplaces": ["amazon.com"],
    "maxProducts": 2,
    "maxSellers": 1,
    "maxOfferPages": 1,
    "includeAllOffers": False,
    "businessCountries": [],
    "excludeBusinessCountries": [],
    "minLifetimeRatings": 0,
    "minPositivePercent": 0,
    "fulfillment": "ANY",
    "excludeAmazonRetail": True,
    "includeFeedback": False,
    "maxFeedbackPerSeller": 0,
}

# Run the Actor and wait for it to finish
run = client.actor("xyrelith-data/amazon-seller-discovery-leads").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 '{
  "mode": "keyword",
  "keywords": [
    "wireless charger"
  ],
  "categoryUrls": [],
  "bestSellerUrls": [],
  "brands": [],
  "asins": [],
  "marketplaces": [
    "amazon.com"
  ],
  "maxProducts": 2,
  "maxSellers": 1,
  "maxOfferPages": 1,
  "includeAllOffers": false,
  "businessCountries": [],
  "excludeBusinessCountries": [],
  "minLifetimeRatings": 0,
  "minPositivePercent": 0,
  "fulfillment": "ANY",
  "excludeAmazonRetail": true,
  "includeFeedback": false,
  "maxFeedbackPerSeller": 0
}' |
apify call xyrelith-data/amazon-seller-discovery-leads --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,xyrelith-data/amazon-seller-discovery-leads"
        }
    }
}
```

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/YHA5r9upXVfXbZWc8/builds/svyCUjXMdJfmabGYX/openapi.json
