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 json { "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 json { "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 json { "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: json { "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: json { "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: javascript // 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. ---