# Free Amazon Seller Products Scraper (`easyparser/amazon-seller-products`) Actor

Retrieve Amazon seller product listings including ASIN, title, price, rating, Prime status, brand, categories, availability, and refinement filters by seller ID or storefront URL.

- **URL**: https://apify.com/easyparser/amazon-seller-products.md
- **Developed by:** [Easyparser](https://apify.com/easyparser) (community)
- **Categories:** E-commerce
- **Features:** Limited permissions
- **Stats:** 20 total users, 5 monthly users, 94.6% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 easyparser credit (built-in key)s

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

## Free Amazon Seller Products Scraper

Retrieve Amazon seller product listings in real-time, including ASIN, title, price, rating, Prime status, brand, categories, shipping details, availability, and storefront refinements. Powered by [Easyparser's](https://easyparser.com) real-time Seller Products API.

> **No API key required to get started.** This actor includes a shared demo key so you can try it immediately. For higher limits and bulk processing, [sign up free at Easyparser](https://app.easyparser.com/signup).

***

### What This Actor Returns

Each run produces one dataset row per seller product, plus one metadata row with refinements, pagination, and delivery context.

**Per product row:**

| Field | Description |
|-------|-------------|
| `seller_id` | The queried seller ID |
| `seller_domain` | The Amazon marketplace queried |
| `source_page` | Page number this product came from |
| `position` | Ranking position in the seller storefront |
| `asin` | Amazon Standard Identification Number |
| `title` | Full product title |
| `brand` | Brand name when available |
| `link` | Direct Amazon product URL |
| `image` | Product image identifier or URL |
| `product_type` | Amazon product type |
| `is_prime` | Whether the product is Prime eligible |
| `is_sponsored` | Whether the listing is sponsored |
| `price`, `price_raw`, `price_currency` | Current listing price |
| `rrp`, `rrp_raw` | Recommended retail price when available |
| `rating`, `rating_text`, `ratings_total` | Product rating and review count |
| `categories` | Product categories |
| `color_options` | Available color variation summary |
| `shipping_details` | Delivery estimate text |
| `availability` | Availability information when present |
| `quantity` | Quantity information when present |

**Metadata row** (`_type: "seller_products_metadata"`):

- `total_products_returned`, `pages_fetched`
- `refinements` - storefront filters like availability, condition, department, and delivery
- `pagination` - page links and counts
- `delivered_to` - delivery location shown by Amazon

***

### How to Use

#### Option A - Try It Now (No Sign-Up)

Fill in the `seller_id` (or `url`) and `domain` fields and run. A shared Easyparser key is built in.

#### Option B - Use Your Own API Key (Recommended for Scale)

1. Sign up free at [app.easyparser.com/signup](https://app.easyparser.com/signup) - **100 free credits/month**, no credit card required
2. Copy your API key from the [Plan Page](https://app.easyparser.com/account/plan)
3. Paste it into the `api_key` field

***

### Input Fields

| Field | Required | Description |
|-------|----------|-------------|
| `seller_id` | Yes\* | Amazon seller ID (e.g. `A1MCYUGJD2ILFU`). You can also use `url` or the list fields below |
| `url` | Yes\* | Full Amazon seller storefront URL |
| `seller_ids` | No | List of seller IDs to process in one run (bulk) |
| `urls` | No | List of seller storefront URLs to process in one run (bulk) |
| `domain` | Yes | Amazon marketplace (e.g. `.com`, `.co.uk`, `.de`) |
| `sort_by` | No | Sort order string such as `exact-aware-popularity-rank` |
| `exclude_refinements` | No | Exclude storefront refinements from the response. Default: false |
| `language` | No | Language code for the storefront page (e.g. `en_US`, `de_DE`) |
| `parameters` | No | Extra query parameters such as `p_n_availability=2661601011&n=228013` |
| `max_pages` | No | Pages to retrieve (1-5). Each page costs 1 credit. Default: 1 |
| `api_key` | No | Your personal Easyparser API key (shared demo key used if empty) |

**Note:** Provide either `seller_id` or `url`, not both. Using `seller_id` is simpler and recommended for automation.

**Note on pagination:** Each page consumes 1 credit. Use higher values only when the seller has a large catalog and you need more than the first page.

**Note on geographic location (address):** The Easyparser API supports simulating a specific zip code via an `address_id` parameter. This feature is available when using the API directly through your Easyparser account. It is not exposed as an input field in this Actor. To use it, call the API directly at [docs.easyparser.com](https://docs.easyparser.com/real-time-integration/seller-products/request).

***

### Example

**Input:**

```json
{
  "seller_id": "A1MCYUGJD2ILFU",
  "domain": ".com",
  "max_pages": 1
}
```

**Output (one row per product):**

```json
{
  "seller_id": "A1MCYUGJD2ILFU",
  "seller_domain": ".com",
  "source_page": 1,
  "position": 0,
  "asin": "B0FJRQC5LZ",
  "title": "OLANLY Memory Foam Bath Mat 30x20...",
  "brand": "OLANLY",
  "link": "https://www.amazon.com/OLANLY-Absorbent-Bathroom-Washable-Accessories/dp/B0FJRQC5LZ/",
  "image": "919C-98QIiL",
  "product_type": "RUG",
  "is_prime": true,
  "is_sponsored": false,
  "price": 7.59,
  "price_raw": "$7.59",
  "price_currency": "USD",
  "rating": 4.5,
  "rating_text": "4.5 out of 5 stars",
  "ratings_total": 397,
  "categories": [{ "id": "aps", "name": "All Departments" }],
  "color_options": { "raw": "+24", "total_count": 30 },
  "shipping_details": "FREE delivery Wed, Mar 18 on $35 of items shipped by Amazon"
}
```

**Bulk input (many items in one run):**

```json
{
  "seller_ids": [
    "A1MCYUGJD2ILFU",
    "A1H9NXUVFQNAQC"
  ],
  "domain": ".com"
}
```

\* Provide at least one value in the single field or the list fields. Items are processed 5 at a time and each one is saved to the dataset as soon as it finishes. If an item fails, the run continues with the others and the failed items are listed in the `FAILED_ITEMS` record of the run's key-value store. When the run reaches your maximum cost per run, the remaining items are skipped.

***

### Use Cases

- **Competitive Portfolio Analysis**: Track a seller's full catalog, pricing strategy, and assortment changes over time
- **Product Research and Sourcing**: Discover what top sellers stock and identify promising products and niches
- **Market Trend Identification**: Monitor changes in seller listings, prices, and availability to spot demand shifts
- **Brand Protection and Enforcement**: Track unauthorized sellers and collect structured evidence about their listed products
- **Inventory Monitoring**: Follow stock and availability signals across seller catalogs in different marketplaces
- **Seller Intelligence Tools**: Build seller tracking dashboards, research tools, or monitoring systems on top of structured storefront data
- **Online Arbitrage and Reselling**: Observe profitable products and pricing patterns from leading sellers
- **At-Scale Catalog Auditing**: Combine pages and repeated runs to analyze large seller portfolios over time

***

### Need More?

For **better pricing**, **higher limits**, and **dedicated throughput**:

- 🚀 [Sign Up Free](https://app.easyparser.com/signup) - 100 credits/month, no credit card
- 💰 [View Pricing Plans](https://easyparser.com/pricing)
- 🎮 [Try the API Playground](https://app.easyparser.com/playground)
- 📄 [Full Documentation](https://docs.easyparser.com/real-time-integration/seller-products)

***

### Related Actors

- [Free Amazon Seller Profile Scraper](https://apify.com/easyparser/amazon-seller-profile): Legal business identity, address, feedback summary, and recent seller feedback
- [Free Amazon Search Results Scraper](https://apify.com/easyparser/amazon-search-results): Ranked listings by keyword or URL with price, rating, Prime, and sponsored flags
- [Free Amazon Product Detail Scraper](https://apify.com/easyparser/amazon-product-detail): Full product data including title, price, ratings, images, specifications, and variants
- [Free Amazon Product Offers Scraper](https://apify.com/easyparser/amazon-product-offers): All seller offers with pricing, Buy Box winner, and fulfillment details

***

### About Easyparser

[Easyparser](https://easyparser.com) is a real-time Amazon scraping API built for developers and data teams. No IP blocks, no CAPTCHAs, fast response times.

# Actor input Schema

## `seller_id` (type: `string`):

Amazon seller ID to query. Use either seller_id or url, not both. Example: A1MCYUGJD2ILFU

## `url` (type: `string`):

Full Amazon seller storefront URL. Use instead of seller_id if needed.

## `seller_ids` (type: `array`):

Optional list of Amazon seller IDs to process in one run, one per line. Can be combined with the single seller ID field.

## `urls` (type: `array`):

Optional list of Amazon seller storefront URLs to process in one run, one per line.

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

The Amazon marketplace to query.

## `sort_by` (type: `string`):

Sort the seller catalog by a specific Amazon sort order. Leave empty for default order.

## `exclude_refinements` (type: `boolean`):

If enabled, refinement filters are excluded from the response.

## `language` (type: `string`):

Language code to request the seller storefront in. Leave empty for the default marketplace language.

## `parameters` (type: `string`):

Additional query parameters to append, for example p_n_availability=2661601011\&n=228013.

## `max_pages` (type: `integer`):

Number of seller product pages to retrieve. Each page consumes 1 credit. Maximum is 5 pages.

## `api_key` (type: `string`):

Your personal Easyparser API key for higher request limits. Leave empty to use the shared demo key. Get your own free key at https://app.easyparser.com/signup - 100 free credits/month, no credit card required.

## Actor input object example

```json
{
  "seller_id": "A1MCYUGJD2ILFU",
  "url": "https://www.amazon.com/s?me=A1MCYUGJD2ILFU",
  "seller_ids": [
    "A1MCYUGJD2ILFU",
    "A1H9NXUVFQNAQC"
  ],
  "urls": [
    "https://www.amazon.com/s?me=A1MCYUGJD2ILFU"
  ],
  "domain": ".com",
  "sort_by": "exact-aware-popularity-rank",
  "exclude_refinements": false,
  "language": "",
  "parameters": "p_n_availability=2661601011&n=228013",
  "max_pages": 1
}
```

# Actor output Schema

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

Dataset containing seller product listings with ASIN, title, price, rating, Prime status, categories, availability, and one metadata item with refinements and pagination.

# 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 = {
    "seller_id": "A1H9NXUVFQNAQC",
    "domain": ".com"
};

// Run the Actor and wait for it to finish
const run = await client.actor("easyparser/amazon-seller-products").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 = {
    "seller_id": "A1H9NXUVFQNAQC",
    "domain": ".com",
}

# Run the Actor and wait for it to finish
run = client.actor("easyparser/amazon-seller-products").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 '{
  "seller_id": "A1H9NXUVFQNAQC",
  "domain": ".com"
}' |
apify call easyparser/amazon-seller-products --silent --output-dataset

```

## MCP server setup

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

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/e0byGF6PhZ0YkFV3F/builds/Y7GQ0fU0MdcRaa816/openapi.json
