Amazon Reviews + Stats Scraper

Support@ wibuild.in@gmail.com

Scrape structured Amazon product reviews and high-level review statistics for a given ASIN across multiple Amazon marketplaces.

Supported domains:

• amazon.com
• amazon.ca
• amazon.co.jp
• amazon.co.uk
• amazon.in
• amazon.de

The actor collects up to 500 reviews per ASIN (subject to Amazon’s current layout and limits).

---

What this actor does

Given a product ASIN and a domain, the actor:

1. Navigates to the product’s review pages.
2. Applies optional filters (by rating, reviewer type, sort order, etc.).
3. Scrapes up to the first 500 reviews matching your criteria.
4. Outputs:
   • A list of reviews with detailed fields.
   • Aggregate stats (average rating, rating distribution, review counts, etc.).

---

Typical use cases

• Monitor product reputation over time.
• Analyze customer sentiment and pain points.
• Compare review patterns across regions (e.g., .com vs .co.uk).
• Export reviews to CSV/JSON for BI tools and data analysis.
• Build dashboards showing rating distribution and review trends.

---

Input

The actor accepts a JSON object with the following fields:

Field	Type	Required	Default	Description
asin	string	Yes	–	Amazon Standard Identification Number, e.g. "B08N5WRWNW".
domain	string	Yes	–	Amazon domain without amazon. prefix. One of: com, ca, co.jp, co.uk, in, de.
maxPages	number	No	10	Maximum number of review pages to scrape. The actor will stop earlier if there are no more reviews or it hits the 500-review cap.
reviewerType	string	No	"all_reviews"	Filter by reviewer type. Typical values: "all_reviews" or "avp_only_reviews" (Amazon Verified Purchase only), depending on the marketplace UI.
sortBy	string	No	"recent"	Sort order of reviews. Common options: "recent", "helpful" (mapped to Amazon’s sort options).
formatType	string	No	"all_formats"	Filter by review format. Example: "all_formats", "current_format", (availability varies by marketplace).
filterByStar	string	No	"all"	Filter reviews by star rating. Example: "1", "2", "3", "4", "5", "all".
proxyConfig	object	No	null	Proxy configuration if your platform supports it (recommended for stability).
maxReviews	number	No	500	Absolute cap on number of reviews to return per ASIN. Even if maxPages would allow more, the actor stops at this limit.

Note: Actual accepted values for reviewerType, sortBy, formatType and filterByStar may depend on Amazon’s current UI. The actor maps these values to the closest available filter per domain.

Example input

{
  "asin": "B08N5WRWNW",
  "domain": "com",
  "maxPages": 15,
  "reviewerType": "avp_only",
  "sortBy": "recent",
  "formatType": "all",
  "filterByStar": "5",
  "maxReviews": 500
}

---

Output

The actor writes all results into the dataset. Each run typically produces:

• One stats record per ASIN.
• One record per review.

Review record schema

Each review item has fields similar to:

{
    "Domain": "com",
    "Asin": "B0DF74L6N2",
    "Product Name": "Cordless Vacuum Cleaner, 600W 50KPA 70Mins Vacuum Cleaners for Home, Stick Vacuum with Charging Dock Station, Anti-tangle Wireless Vacumm, Rechargeable Cordless Vacuum for Pet Hair/Carpet/Hard Floor",
    "Total Rating Count": "1,965",
    "Rating": 5,
    "Title": "Solid Vacuum!",
    "Review": "This vacuum works very well. The suction is good, the brush motor is strong enough to still spin even if pressure is applied to it, the battery is removable, and it’s lightweight. Even our 5 year old can maneuver it with ease.",
    "Badge": "Verified Purchase",
    "Helpful": "",
    "Username": "Amazon Customer",
    "Review Date": "2025-11-13",
    "Country Name": "United States",
    "Variants": "",
    "Vine Customer": "",
    "Global Rating Count": "2,629",
    "Average Rating": "4.6",
    "5 Star %": 81,
    "4 Star %": 10,
    "3 Star %": 3,
    "2 Star %": 2,
    "1 Star %": 4,
    "Date of Crawling": "2025-11-15"
  },

Some fields may be null or missing depending on the marketplace and the specific review (for example, not all reviews have images or videos).

totalReviewsOnAmazon is the number shown by Amazon on the product page, which may be higher than totalReviewsScraped due to the 500-review limit or filters.

---

How the limits work

• The actor will never scrape more than maxReviews reviews per ASIN (default 500).
• It paginates through the review pages up to maxPages.
• If it reaches the maxReviews limit before maxPages, it stops early.
• If there are fewer reviews available than requested (e.g., product only has 120 reviews), it will scrape only what’s available.

---

Notes & disclaimer

• This actor is not affiliated with or endorsed by Amazon.
• Use it responsibly and in accordance with:
  • Amazon’s Terms of Service.
  • Your local laws and regulations.
• Avoid overloading Amazon’s servers: be mindful of how frequently and how aggressively you scrape.

---

Changelog

• v1.0.0
  • Initial release.
  • Support for .com, .ca, .co.jp, .co.uk, .in, .de.
  • Up to 500 reviews per ASIN.
  • Basic filters and aggregated stats.