Amazon Seller Products Actor Documentation

Overview

The Amazon Seller Products Actor is an Apify Actor designed to scrape product listings from Amazon seller pages. This actor extracts comprehensive product information including titles, prices, ratings, reviews, delivery options, and more from any Amazon seller's product catalog.

Features

• 🛒 Complete Product Data Extraction: Retrieves ASIN, title, price, ratings, reviews, images, and delivery information
• 🌍 Multi-Region Support: Works with 24+ Amazon regional sites
• 📄 Pagination Support: Navigate through multiple pages of seller products
• 🔄 Flexible Sorting: Sort products by featured, price, reviews, or newest arrivals
• ⚡ Fast & Reliable: Built on Apify infrastructure for scalable web scraping
• 📊 Structured Output: Returns clean, structured JSON data ready for analysis

Input Parameters

Required Parameters

Parameter	Type	Description
sellerUrl	string	The Amazon seller URL (e.g., https://www.amazon.com/sp?seller=A393XY2DO5OC7B)
countryIso	string	Two-letter country ISO code for Amazon regional site (default: "us")

Optional Parameters

Parameter	Type	Description	Default
page	integer	Page number for pagination (starting from 1)	1
sortBy	string	Sort products by different criteria	"featured"

Supported Country Codes

The actor supports the following Amazon regional sites:

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

Sort Options

Value	Description
featured	Featured products (default)
price-asc	Price: Low to High
price-desc	Price: High to Low
review-rank	Customer Reviews
newest	Newest Arrivals

Input Schema Example

{
  "sellerUrl": "https://www.amazon.com/sp?seller=A393XY2DO5OC7B",
  "page": 1,
  "countryIso": "us",
  "sortBy": "featured"
}

Output Format

The actor returns an array of product objects with the following structure:

Product Object Structure

{
  "asin": "B0BRKPVZB4",
  "title": "Bluetooth Speaker with HD Sound, Portable Wireless, IPX5 Waterproof...",
  "url": "https://www.amazon.com/Bluetooth-Waterproof-Playtime-Portable-Electronic/dp/B0BRKPVZB4/...",
  "image": "https://m.media-amazon.com/images/I/81l7mB5LhsL._AC_UY650_.jpg",
  "price": "$19.99",
  "rating": "4.4 out of 5 stars",
  "reviews": "24,932",
  "delivery": "FREE delivery Sun, Jun 8 on $35 of items shipped by Amazon",
  "sponsored": false,
  "prime": true,
  "extraInfo": "Or fastest delivery Tomorrow, Jun 4"
}

Field Descriptions

Field	Type	Description
asin	string	Amazon Standard Identification Number
title	string	Product title
url	string	Direct link to the product page
image	string	Product image URL
price	string	Product price (formatted with currency)
rating	string	Product rating (e.g., "4.4 out of 5 stars")
reviews	string	Number of reviews
delivery	string	Delivery information
sponsored	boolean	Whether the product is sponsored
prime	boolean	Whether the product has Prime shipping
extraInfo	string	Additional delivery or promotional information

Example Output

{
  "results": [
    {
      "asin": "B0BRKPVZB4",
      "title": "Bluetooth Speaker with HD Sound, Portable Wireless, IPX5 Waterproof, Up to 20H Playtime, TWS Pairing, BT5.3, for Home/Party/Outdoor/Beach, Electronic Gadgets, Birthday Gift (Black)Carbonfree Certified",
      "url": "https://www.amazon.com/Bluetooth-Waterproof-Playtime-Portable-Electronic/dp/B0BRKPVZB4/ref=sr_1_1?...",
      "image": "https://m.media-amazon.com/images/I/81l7mB5LhsL._AC_UY650_.jpg",
      "price": "$19.99",
      "rating": "4.4 out of 5 stars",
      "reviews": "24,932",
      "delivery": "FREE delivery Sun, Jun 8 on $35 of items shipped by Amazon",
      "sponsored": false,
      "prime": true,
      "extraInfo": "Or fastest delivery Tomorrow, Jun 4"
    },
    {
      "asin": "B0CKXH2Q4M",
      "title": "Upgraded Outdoor Speakers Gift for Men Bluetooth Speaker with lights Multi-Sync up to 100 Speakers Auto-Pairing HD Stereo Sound Cool Tech Gadgets for Him IPX5 Waterproof for Outside|Patio|Porch",
      "url": "https://www.amazon.com/Upgraded-Bluetooth-Multi-Sync-Auto-Pairing-Waterproof/dp/B0CKXH2Q4M/ref=sr_1_2?...",
      "image": "https://m.media-amazon.com/images/I/81mkyyGVDuL._AC_UY650_.jpg",
      "price": "$84.99",
      "rating": "4.4 out of 5 stars",
      "reviews": "623",
      "delivery": "FREE delivery Sun, Jun 8",
      "sponsored": false,
      "prime": true,
      "extraInfo": "Or fastest delivery Tomorrow, Jun 4"
    }
  ],
  "pagination": {},
  "relatedSearch": []
}

Usage Examples

Basic Usage

Scrape the first page of a seller's products:

{
  "sellerUrl": "https://www.amazon.com/sp?seller=A393XY2DO5OC7B",
  "countryIso": "us"
}

Advanced Usage

Scrape page 2 of products sorted by price (low to high) from Amazon UK:

{
  "sellerUrl": "https://www.amazon.co.uk/sp?seller=A393XY2DO5OC7B",
  "page": 2,
  "countryIso": "gb",
  "sortBy": "price-asc"
}

Multiple Pages

To scrape multiple pages, run the actor multiple times with different page numbers or implement a loop in your code:

// Example: Scrape first 3 pages
const pages = [1, 2, 3];
for (const page of pages) {
  const input = {
    sellerUrl: "https://www.amazon.com/sp?seller=A393XY2DO5OC7B",
    page: page,
    countryIso: "us",
    sortBy: "featured"
  };
  // Run actor with this input
}

How to Find Seller URLs

1. Go to any Amazon product page
2. Click on the seller name (usually found below the price)
3. This will take you to the seller's storefront
4. Copy the URL from your browser's address bar
5. The URL should look like: https://www.amazon.com/sp?seller=SELLER_ID

Error Handling

The actor includes comprehensive error handling:

• Invalid Seller URL: The actor will extract the seller ID from the URL automatically
• Network Issues: Built-in retry mechanisms for failed requests

Best Practices

1. Respect Rate Limits: Don't run too many concurrent instances to avoid being blocked
2. Use Appropriate Delays: Consider adding delays between requests for large-scale scraping
3. Monitor Results: Check the output for any missing or malformed data
4. Regional Consistency: Use the correct country ISO code that matches your seller URL
5. Pagination: For sellers with many products, iterate through multiple pages

---

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.

---