# Amazon Seller Info Scraper (`pintostudio/amazon-seller-info-scraper`) Actor

The Amazon Seller Info Actor is an Apify actor designed to extract comprehensive seller information from Amazon marketplace.

- **URL**: https://apify.com/pintostudio/amazon-seller-info-scraper.md
- **Developed by:** [Pinto Studio](https://apify.com/pintostudio) (community)
- **Categories:** E-commerce, Other, Integrations
- **Features:** Limited permissions
- **Stats:** 94 total users, 1 monthly users, 100.0% runs succeeded, 5 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.80 / 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/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 Seller Info Actor Documentation

### Overview

The Amazon Seller Info Actor is an Apify actor designed to extract comprehensive seller information from Amazon marketplace. This actor takes Amazon seller URLs as input and returns detailed seller data including ratings, business information, and performance metrics.

### Features

- Extract seller information from Amazon seller profile pages
- Support for multiple Amazon regional sites (24+ countries)
- Detailed rating breakdowns and performance metrics
- Business information and contact details
- Batch processing of multiple seller URLs
- Comprehensive seller analytics

### Input Configuration

#### Required Parameters

##### `sellerUrls` (Array)

- **Type**: Array of objects with `url` property
- **Description**: Array of Amazon seller URLs to scrape
- **Format**: Each object should contain a `url` field with the Amazon seller page URL
- **Example**:

```json
[
  { "url": "https://www.amazon.com/sp?ie=UTF8&seller=A2OGGJZ4EYAAFT&asin=B08BKZTZNT&ref_=dp_merchant_link&isAmazonFulfilled=1" },
  { "url": "https://www.amazon.com/sp?seller=A393XY2DO5OC7B" }
]
```

##### `countryIso` (String)

- **Type**: String (2-letter ISO country code)
- **Description**: Specifies which Amazon regional site to scrape from
- **Default**: `"us"`
- **Supported Countries**:
  - `au` - Australia
  - `be` - Belgium
  - `br` - Brazil
  - `ca` - Canada
  - `cn` - China
  - `eg` - Egypt
  - `fr` - France
  - `de` - Germany
  - `in` - India
  - `ie` - Ireland
  - `it` - Italy
  - `jp` - Japan
  - `mx` - Mexico
  - `nl` - Netherlands
  - `pl` - Poland
  - `sa` - Saudi Arabia
  - `sg` - Singapore
  - `za` - South Africa
  - `es` - Spain
  - `se` - Sweden
  - `tr` - Turkey
  - `ae` - United Arab Emirates
  - `gb` - United Kingdom
  - `us` - United States

#### Input Schema Example

```json
{
  "sellerUrls": [
    { "url": "https://www.amazon.com/sp?seller=A2OGGJZ4EYAAFT" },
    { "url": "https://www.amazon.com/sp?seller=A393XY2DO5OC7B" }
  ],
  "countryIso": "us"
}
```

### Output Data Structure

The actor returns detailed seller information for each processed URL. Here's the structure of the output data:

#### Main Seller Information

- `id`: Amazon seller ID (e.g., "A2OGGJZ4EYAAFT")
- `name`: Seller display name
- `rating`: Overall seller rating (0-5 scale)
- `positivePercent`: Percentage of positive feedback
- `isAmazon`: Boolean indicating if this is Amazon as a seller

#### Rating Breakdown

The `ratingBreakdown` object contains percentage distribution:

- `5-star`: Percentage of 5-star ratings
- `4-star`: Percentage of 4-star ratings
- `3-star`: Percentage of 3-star ratings
- `2-star`: Percentage of 2-star ratings
- `1-star`: Percentage of 1-star ratings

#### Detailed Ratings by Time Period

The `detailedRatings` object provides granular rating data across different time periods:

##### Time Periods

- `oneMonth`: Last 30 days
- `threeMonth`: Last 90 days
- `twelveMonth`: Last 12 months
- `lifeTime`: All-time ratings

##### Metrics for Each Period

- `ratingCount`: Total number of ratings
- `ratingCountWithText`: Number of ratings with written reviews
- `star1Count`, `star2Count`, etc.: Count of ratings for each star level
- `star1CountWithText`, `star2CountWithText`, etc.: Count of text reviews for each star level
- `star1`, `star2`, etc.: Percentage distribution for each star level

#### Business Information

- `aboutSeller`: Seller description and policies
- `businessInfo`:
  - `name`: Legal business name
  - `address`: Business address
- `storefrontUrl`: Direct link to seller's Amazon storefront

#### Example Output

```json
{
  "id": "A393XY2DO5OC7B",
  "name": "BolaButty Audio Direct",
  "rating": 4.9,
  "positivePercent": 100,
  "ratingBreakdown": {
    "5-star": 91,
    "4-star": 9,
    "3-star": 0,
    "2-star": 0,
    "1-star": 0
  },
  "detailedRatings": {
    "lifeTime": {
      "star5Count": 3437,
      "star4Count": 337,
      "star3Count": 0,
      "star2Count": 2,
      "star1Count": 5,
      "ratingCount": 3781,
      "ratingCountWithText": 3767,
      "star5": 91,
      "star4": 9,
      "star3": 0,
      "star2": 0,
      "star1": 0
    }
  },
  "aboutSeller": "Adhering to the product concept of \"Pursuing Perfect Sound Quality\"...",
  "businessInfo": {
    "name": "AUDIO JAY INC.",
    "address": "2000 AUBURN DR STE 200-392"
  },
  "isAmazon": false,
  "storefrontUrl": "https://www.amazon.com/s?ie=UTF8&marketplaceID=ATVPDKIKX0DER&me=A393XY2DO5OC7B"
}
```

### Usage Instructions

#### 1. Basic Usage

1. Navigate to the Amazon Seller Info Actor on Apify platform
2. Configure the input with your desired seller URLs and country code
3. Start the actor
4. Download results from the actor's dataset

#### 2. How to Find Amazon Seller URLs

To get the seller URL for use with this actor, follow these steps on any Amazon product page:

1. **Navigate to any Amazon product page** where you want to analyze the seller
2. **Locate the seller information** on the right side of the page in the product details section
3. **Look for the "Sold by" section** - you'll see the seller name (e.g., "BolaButty Audio Direct")
4. **Click on the seller name** - this will take you to the seller's profile page
5. **Copy the URL** from your browser's address bar - this is the seller URL you need

**Example**: In the product page shown above, you would click on "BolaButty Audio Direct" to get the seller URL like:
`https://www.amazon.com/sp?seller=A393XY2DO5OC7B`

#### 3. Supported URL Formats

The actor accepts various Amazon seller URL formats:

- `https://www.amazon.com/sp?seller=SELLER_ID`
- `https://www.amazon.com/sp?ie=UTF8&seller=SELLER_ID&asin=PRODUCT_ID`
- Any Amazon seller profile URL containing the seller ID

#### 3. Batch Processing

You can process multiple sellers in a single run by providing multiple URLs in the `sellerUrls` array.

### Rate Limits and Best Practices

- The actor respects Amazon's rate limits to avoid blocking
- For large batches of sellers, consider running the actor with reasonable delays
- Monitor your Apify usage to stay within platform limits

### Error Handling

The actor includes comprehensive error handling:

- Invalid URLs are logged and skipped
- Network errors are retried automatically
- Malformed seller pages are handled gracefully

### Technical Requirements

- **Platform**: Apify
- **Memory**: Minimum 512MB recommended
- **Timeout**: 5-10 minutes per seller URL (depending on data complexity)

### Use Cases

- **Competitor Analysis**: Monitor competitor seller performance and ratings
- **Supplier Verification**: Verify seller credibility before partnerships
- **Market Research**: Analyze seller landscape in specific categories
- **Due Diligence**: Research potential business partners or acquisition targets
- **Performance Monitoring**: Track your own seller metrics over time

### Support and Troubleshooting

#### Common Issues

1. **Invalid Seller URL**: Ensure URLs contain valid Amazon seller IDs
2. **Country Mismatch**: Verify the `countryIso` matches the Amazon domain in your URLs
3. **Rate Limiting**: If you encounter blocks, reduce the batch size or add delays

***

### Support

If you have any questions or encounter any issues, please consult the Apify documentation or reach out to us through one of the following channels:

- **Telegram**: [@pintoflow](https://t.me/pintoflow)
- **Email**: <pintoflowpt@gmail.com>
- **Apify Platform**: You can also contact us directly through this platform.

***

# Actor input Schema

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

The seller Main page URLs to get the data from.

## `countryIso` (type: `string`):

Two-letter country ISO code for Amazon regional site

## Actor input object example

```json
{
  "sellerUrls": [
    {
      "url": "https://www.amazon.com/sp?ie=UTF8&seller=A2OGGJZ4EYAAFT&asin=B08BKZTZNT&ref_=dp_merchant_link&isAmazonFulfilled=1"
    },
    {
      "url": "https://www.amazon.com/sp?seller=A393XY2DO5OC7B"
    }
  ],
  "countryIso": "us"
}
```

# 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 = {
    "sellerUrls": [
        {
            "url": "https://www.amazon.com/sp?ie=UTF8&seller=A2OGGJZ4EYAAFT&asin=B08BKZTZNT&ref_=dp_merchant_link&isAmazonFulfilled=1"
        },
        {
            "url": "https://www.amazon.com/sp?seller=A393XY2DO5OC7B"
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("pintostudio/amazon-seller-info-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 = { "sellerUrls": [
        { "url": "https://www.amazon.com/sp?ie=UTF8&seller=A2OGGJZ4EYAAFT&asin=B08BKZTZNT&ref_=dp_merchant_link&isAmazonFulfilled=1" },
        { "url": "https://www.amazon.com/sp?seller=A393XY2DO5OC7B" },
    ] }

# Run the Actor and wait for it to finish
run = client.actor("pintostudio/amazon-seller-info-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 '{
  "sellerUrls": [
    {
      "url": "https://www.amazon.com/sp?ie=UTF8&seller=A2OGGJZ4EYAAFT&asin=B08BKZTZNT&ref_=dp_merchant_link&isAmazonFulfilled=1"
    },
    {
      "url": "https://www.amazon.com/sp?seller=A393XY2DO5OC7B"
    }
  ]
}' |
apify call pintostudio/amazon-seller-info-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,pintostudio/amazon-seller-info-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/cOEejieGBo3Fk8T0P/builds/9xZZcFHTr66fgL4GM/openapi.json