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:

[
  { "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

{
  "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

{
  "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
• Email: pintoflowpt@gmail.com
• Apify Platform: You can also contact us directly through this platform.

---