Amazon BestSeller Actor Documentation

Overview

The Amazon BestSeller Actor is a web scraping tool deployed on the Apify platform that extracts best-selling products from Amazon across multiple product categories and countries. This actor provides comprehensive data about top-performing products including pricing, ratings, review counts, and product details.

Features

• Multi-Country Support: Scrapes Amazon bestsellers from 24 different countries
• Multiple Product Categories: Covers various Amazon categories like Apps & Games, Sports & Outdoors, Grocery & Gourmet Food, and Clothing, Shoes & Jewelry
• Comprehensive Product Data: Extracts detailed information including titles, prices, ratings, review counts, and product URLs
• Structured Output: Returns well-organized JSON data with category sections and product rankings

Input Configuration

Required Parameters

Parameter	Type	Description	Default
countryIso	String	Two-letter ISO country code for Amazon regional site	"us"

Supported Countries

The actor supports the following 24 countries:

• Australia (au)
• Belgium (be)
• Brazil (br)
• Canada (ca)
• China (cn)
• Egypt (eg)
• France (fr)
• Germany (de)
• India (in)
• Ireland (ie)
• Italy (it)
• Japan (jp)
• Mexico (mx)
• Netherlands (nl)
• Poland (pl)
• Saudi Arabia (sa)
• Singapore (sg)
• South Africa (za)
• Spain (es)
• Sweden (se)
• Turkey (tr)
• United Arab Emirates (ae)
• United Kingdom (gb)
• United States (us)

Input Schema Example

{
  "countryIso": "us"
}

Output Format

The actor returns a structured JSON object containing bestseller data organized by product categories.

Output Structure

{
  "departments": [],
  "productSections": [
    {
      "section": "Category Name",
      "urlSection": "Amazon category URL",
      "products": [
        {
          "id": "Product ASIN",
          "rank": 1,
          "title": "Product Title",
          "imageURL": "Product Image URL",
          "rating": 4.5,
          "reviewCount": 12345,
          "price": "$19.99",
          "url": "Amazon Product URL"
        }
      ]
    }
  ]
}

Data Fields Explanation

Product Section Fields:

• section: Name of the product category (e.g., "Best Sellers in Apps & Games")
• urlSection: Direct URL to the Amazon bestsellers page for this category
• products: Array of top-ranked products in this category

Individual Product Fields:

• id: Amazon Standard Identification Number (ASIN)
• rank: Bestseller rank within the category (1-6 typically)
• title: Full product name/title
• imageURL: Direct URL to product image
• rating: Average customer rating (1-5 scale)
• reviewCount: Total number of customer reviews
• price: Current product price in local currency
• url: Direct Amazon product page URL

Sample Output

Based on the provided data, here's an example of what the actor returns:

{
  "departments": [],
  "productSections": [
    {
      "section": "Best Sellers in Apps & Games",
      "urlSection": "https://www.amazon.com/gp/bestsellers/mobile-apps/ref=zg_bs_mobile-apps_sm",
      "products": [
        {
          "id": "B0DS2J9WLR",
          "rank": 1,
          "title": "Save the Pet - Brain Puzzle Game PRO",
          "imageURL": "https://images-na.ssl-images-amazon.com/images/I/71KX2oEtznL._AC_UL225_SR225,160_.png",
          "rating": 3.7,
          "reviewCount": 61,
          "price": "$9.99",
          "url": "https://www.amazon.com/Save-Pet-Brain-Puzzle-Game/dp/B0DS2J9WLR/..."
        },
        {
          "id": "B00992CF6W",
          "rank": 2,
          "title": "Minecraft",
          "imageURL": "https://images-na.ssl-images-amazon.com/images/I/81gsSy5r13L._AC_UL225_SR225,160_.png",
          "rating": 4.4,
          "reviewCount": 151281,
          "price": "$6.99",
          "url": "https://www.amazon.com/Mojang-Minecraft/dp/B00992CF6W/..."
        }
      ]
    }
  ]
}

Use Cases

E-commerce Research

• Market Analysis: Identify trending products and popular categories
• Competitive Intelligence: Monitor competitor products and pricing
• Product Discovery: Find high-performing products for dropshipping or retail

Business Intelligence

• Pricing Strategy: Analyze pricing patterns of bestselling products
• Review Analysis: Understand customer satisfaction through ratings and review counts
• Market Trends: Track changes in bestseller rankings over time

Academic Research

• Consumer Behavior Studies: Analyze purchasing patterns across different regions
• Market Research: Study product popularity and regional preferences
• Economic Analysis: Compare pricing and product availability across countries

Technical Implementation

Architecture

• Built using Apify SDK for robust web scraping capabilities
• Utilizes Axios for HTTP requests and API interactions
• Implements modular helper functions for scalable code organization

Error Handling

• Comprehensive try-catch blocks for graceful error management
• Detailed logging for debugging and monitoring
• Automatic retry mechanisms for network failures

Running the Actor

On Apify Platform

1. Navigate to the Amazon BestSeller Actor on Apify Console
2. Configure the input with desired countryIso parameter
3. Click "Start" to begin the scraping process
4. Monitor the run through the Apify Console
5. Download results in JSON, CSV, or other formats

Via Apify API

const { ApifyClient } = require('apify-client');

const client = new ApifyClient({
    token: 'YOUR_APIFY_TOKEN',
});

const run = await client.actor('the-actor-id').call({
    countryIso: 'us'
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Rate Limits and Best Practices

Respectful Scraping

• Built-in delays to avoid overwhelming Amazon servers
• Follows robots.txt guidelines and terms of service
• Implements proper user agent rotation

Performance Optimization

• Efficient data extraction algorithms
• Minimal resource consumption
• Optimized for speed while maintaining data quality

Data Freshness

• Captures real-time bestseller data
• Regular updates reflect current market trends
• Timestamps included for temporal analysis

Troubleshooting

Common Issues

1. Country Not Supported: Ensure the countryIso parameter matches one of the 24 supported countries
2. Empty Results: Some regions may have limited product categories or temporary access restrictions
3. Rate Limiting: Actor includes built-in delays, but excessive requests may trigger Amazon's protection mechanisms

---

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.

---