Amazon Customer Review & Rating Summary Scraper

Turn Amazon product pages into a clean review dataset and a product-level rating summary — no login, no cookie, no proxy configuration. Give it product URLs or bare ASINs, or let it find products from a keyword or category page. It works across 23 Amazon storefronts, merges the public review sources, and lets you narrow the result by stars, verified purchases, keywords, date, or media.

What this actor does

• Two ways in: paste productUrls (URLs or bare ASINs) or leave them empty and use keywords / categoryUrls to discover products first. Discovery runs over plain HTTP on Amazon's mobile search page and falls back to a browser only when needed.
• Review rows: rating, headline, full text, date and reviewer location, verified-purchase and Vine labels, helpful votes, variant, and reviewer media — from the public product-page review block. The block is probabilistic, so the actor retries fresh sessions across the desktop and mobile product pages.
• Rating summary, always first: one amazon_review_aggregate record per product with product title, average rating, global ratings count, the 5→1 star histogram, derived per-star counts, and Amazon's "Customers say" summary with aspect sentiment. When the page omits the histogram, the actor fills it from Amazon's own rating-summary popover widget.
• Optional depth: extendedHistory merges Amazon's public extended review feed for US products (up to 100 rows per star/sort bucket; 100–800+ unique on popular ASINs), deduplicated against the product-page sample. mergeMarketplaces additionally unions the product page from other storefronts.
• Filters that narrow the data: star rating (including positive/critical), verified purchases, keyword, date, and media-only. Sorting is most-helpful or most-recent.
• Empty fields are omitted. A record only contains fields the source actually provided — never null or fake placeholders.

Output

Review records

Field	Description
productAsin	ASIN of the requested product.
ratingScore	Star rating, 1–5.
reviewTitle / reviewDescription	Headline and full review text.
reviewUrl / reviewId	Permalink and Amazon review ID when the source exposes them (the extended feed does not).
reviewedIn	Raw "Reviewed in … on …" sentence.
reviewDate / reviewLocation	Parsed ISO date and reviewer country.
isVerified / isVineVoice	Amazon Verified Purchase and Vine badges.
variant	Product variant the reviewer bought, when shown.
reviewReaction / helpfulCount	Raw helpful-vote sentence and parsed count.
reviewImages / reviewVideos	Reviewer media (reviewVideos entries carry a URL and optional thumbnail).
hasImages / imageCount / hasVideos / videoCount	Derived media flags.
sentimentHint	Derived positive / neutral / negative from the rating.
wordCount	Length, character-based for CJK/Hangul text.
position	Rank in the returned set after merging and filtering.
reviewHash	Stable content fingerprint used to deduplicate across sources.
source	productPage, extendedHistory, or cookieMode.
sourceMarketplace	Amazon domain the row came from.
reviewedProductAsin	Variant ASIN the review belongs to, when the page exposes it.
reviewerName / reviewerProfile / reviewerAvatar	Only present when includeGdprSensitive is on.
scrapedAt / sourceUrl	UTC scrape timestamp and the input URL.

Rating summary records

One record per product with type: "amazon_review_aggregate":

Field	Description
productAsin / productTitle	ASIN and product title from the same page.
averageRating / globalRatingsCount	Overall stars and total ratings (not just written reviews).
starsBreakdown	Percentage per star, 5→1.
ratingCountByStar	Derived count per star (percentage × total, rounded).
customersSay / customersSayAspects	Amazon's AI summary and aspect sentiment, when Amazon shows them.
productUrl / sourceUrl / scrapedAt	Canonical product URL, input URL, and timestamp.

Status records

If a run cannot return any review or summary, the dataset receives one typed status record so the run is never silently empty: amazon_reviews_blocked, amazon_reviews_no_star_match, amazon_reviews_no_products_discovered, amazon_reviews_cookie_invalid, amazon_reviews_cookie_expired, or amazon_reviews_cookie_robot_blocked. A blocked page is also reported in the run status message.

Input

Field	Type	Default	Description
productUrls	array	–	Amazon URLs or bare ASINs. Leave empty to use discovery.
keywords	array	[]	Search terms for product discovery.
categoryUrls	array	[]	Amazon search/category URLs for advanced discovery.
maxProductsToDiscover	integer	5	Products per keyword/category URL (1–50).
country	string	amazon.com	Storefront for bare ASINs, discovery, and URLs without a domain (23 options).
maxReviews	integer	100	Per-product cap after merging (1–2000).
extendedHistory	boolean	true	Merge the public extended review feed.
mergeMarketplaces	array	[]	Extra storefronts whose product pages are unioned.
sortBy	string	helpful	helpful or recent.
filterByStar	string	"" (all)	1–5, positive (4–5), or critical (1–2).
verifiedPurchasesOnly	boolean	false	Keep only Verified Purchase reviews.
filterKeywords	array	[]	Keep reviews containing any of these keywords.
reviewsNewerThan	string	"" (none)	Keep reviews on/after this date.
mediaReviewsOnly	boolean	false	Keep only reviews with images or videos.
includeImages	boolean	true	Extract reviewer images and videos.
includeAggregates	boolean	true	Emit the product rating-summary record.
includeGdprSensitive	boolean	false	Include reviewer name/profile/avatar.
cookieString	string	"" (off)	Optional own session cookie for paginated history. Never required.

Examples

Default run — one product, summary plus reviews:

{ "productUrls": ["https://www.amazon.com/dp/B09X7MPX8L"] }

Discovery by keyword:

{ "keywords": ["wireless earbuds"], "maxProductsToDiscover": 5, "maxReviews": 50 }

Critical reviews with media on two products:

{
  "productUrls": ["B09X7MPX8L", "B08TJTCCV8"],
  "filterByStar": "critical",
  "mediaReviewsOnly": true,
  "verifiedPurchasesOnly": true,
  "maxReviews": 100
}

Merge two storefronts:

{
  "productUrls": ["https://www.amazon.de/dp/B09X7MPX8L"],
  "country": "amazon.de",
  "mergeMarketplaces": ["amazon.co.uk", "amazon.fr"],
  "maxReviews": 200
}

Use cases

• Voice of customer: export review text for sentiment, topic, and complaint analysis.
• Rating monitoring: track average rating, histogram, and the "Customers say" summary across a watch-list.
• Competitive research: compare products from a keyword or category with one run.
• Storefront comparison: see which reviews a product carries on other Amazon marketplaces.
• Quality triage: filter to critical or media reviews to find recurring defects quickly.

FAQ

Do I need an Amazon account or a proxy? No. The actor works with public product data and chooses its own connection automatically. cookieString is optional and only for users who want to paginate their own session.

How many reviews can I get per product? The product-page block normally shows 8–13. With extendedHistory on, popular US products can yield several hundred unique reviews (measured 620, 824; up to 100 per star/sort bucket). Coverage varies by ASIN.

Why do some products return fewer rows than others? Amazon gates the product-page block probabilistically and the extended feed only covers a subset of ASINs. The actor retries and reports what it actually collected; it never invents rows.

Why is my star filter returning zero results? Filters run over the merged set, so a rating that is rare on the product page and absent from the feed can legitimately return nothing. The dataset then contains an amazon_reviews_no_star_match status record.

Is the star histogram always available? Yes in practice: the actor reads it from the product page and falls back to Amazon's rating-summary popover when the page omits it. customersSay is source-dependent and appears only when Amazon displays it.

What is ratingCountByStar? A derived count: Amazon publishes percentages, so the actor multiplies each percentage by globalRatingsCount and rounds. It is labelled as derived, not read from a separate count field.

Does this actor cover non-US marketplaces? Yes — 23 storefronts for product-page collection and marketplace merge. The extended review feed is US-only.

Is this affiliated with Amazon? No. It reads publicly available pages and is not endorsed by Amazon.