Amazon Review Aggregates & Extended History Scraper

Pull customer reviews and rating summaries from any Amazon product across 19 marketplaces worldwide. Give it product URLs, bare ASINs, or search keywords, and it returns structured review records plus a per-product rating summary — star breakdown, total ratings count, and Amazon's own AI-generated "Customers say" summary.

What this actor does

• Collects reviews from any Amazon product URL or bare ASIN, or discovers products automatically from search keywords/category URLs.
• Filters by star rating and sorts by most-helpful or most-recent.
• Optionally returns a per-product rating-aggregate record with the average rating, star histogram, total ratings count, and "Customers say" summary.
• Optionally accepts your own Amazon session so a product's review history can go beyond the default per-product cap, including a verified-purchases-only filter.
• Fields a review or product page doesn't provide (e.g. no reviewer images, no Vine Voice flag) are left out of that record.

Output per review

Field	Description
productAsin	Amazon ASIN of the reviewed product.
ratingScore	Star rating, 1–5.
reviewTitle / reviewDescription	Review headline and full text.
reviewUrl	Direct link to the individual review.
reviewReaction	Raw "N people found this helpful" text.
reviewedIn	Raw "Reviewed in <country> on <date>" text.
isVerified	Verified Purchase flag.
isVineVoice	Amazon Vine Voice reviewer flag, when evidenced.
variant	Product variant purchased (e.g. size/color).
reviewImages	Reviewer-uploaded image URLs, when includeImages is on.
reviewVideos	Reviewer-uploaded videos (url, thumbnailUrl), when present.
position	Rank of this review within its product's fetched set.
reviewId	Amazon's own review identifier.
helpfulCount	Parsed numeric helpful-vote count.
reviewDate	Parsed ISO date.
reviewLocation	Parsed reviewer country/region.
sentimentHint	Derived positive / neutral / negative label.
wordCount	Review length.
hasImages / imageCount / hasVideos / videoCount	Derived media counts.
reviewerName / reviewerProfile / reviewerAvatar	Reviewer identity fields, only present when includeGdprSensitive is true.
collectionCompleteness	Set to "INLINE_SAMPLE" only when a deeper fetch fell back to the default per-product sample.
scrapedAt	UTC timestamp of the scrape.
sourceUrl	The product URL that was scraped.

Output per product (rating aggregate)

When includeAggregates is on (default), one additional record per product carries:

Field	Description
type	Always "amazon_review_aggregate".
productAsin	Amazon ASIN.
averageRating	Overall star rating shown on the product page.
globalRatingsCount	Total number of ratings, not just the reviews fetched.
starsBreakdown	Count/percentage per star, 5 through 1.
customersSay	Amazon's AI-generated "Customers say" summary.
customersSayAspects	Per-aspect sentiment breakdown (label, sentiment, mentionCount, summary).
productUrl	Canonical /dp/{ASIN} product URL.
collectionCompleteness	Set to "INLINE_SAMPLE" only when a deeper fetch fell back to the default sample.
scrapedAt / sourceUrl	Scrape timestamp and source URL.

Status records

If a run can't return real reviews for a product, the dataset gets one typed status record instead of being left empty, identified by its type value: amazon_reviews_no_proxy, amazon_reviews_proxy_failed, amazon_reviews_walled_us, amazon_reviews_no_star_match, amazon_reviews_blocked, amazon_reviews_cookie_invalid, amazon_reviews_cookie_expired, amazon_reviews_cookie_robot_blocked, amazon_reviews_auth_required, or amazon_reviews_no_products_discovered.

Input

Field	Type	Default	Description
productUrls	Array of strings	–	Amazon product URLs, or bare ASINs expanded using country. Leave empty to use keywords/categoryUrls instead.
keywords	Array of strings	[]	Search keywords to auto-discover products, used only when productUrls is empty.
categoryUrls	Array of strings	[]	Amazon search/category URLs to auto-discover products from, used only when productUrls is empty.
maxProductsToDiscover	Integer	10	Maximum products to discover from keywords/categoryUrls (1–50).
includeAggregates	Boolean	true	Emit one rating-aggregate record per product.
sourceMode	String (select)	"AUTO"	AUTO picks the deeper fetch automatically when a session is supplied, otherwise the default sample; INLINE_ONLY always uses the default sample and ignores a supplied session; FULL_PAGE always uses the deeper fetch and requires cookieString.
onAuthRequired	String (select)	"RETURN_PARTIAL"	Only used when sourceMode is FULL_PAGE without a valid cookieString: FAIL aborts the run, RETURN_PARTIAL falls back to the default sample and tags those records collectionCompleteness: "INLINE_SAMPLE".
proxyConfiguration	Object	–	Required. An Apify proxy configuration; the actor exits cleanly with a status message if none is set.
maxReviews	Integer	15	Reviews per product (1–15).
sortBy	String (select)	"helpful"	helpful or recent.
filterByStar	String (select)	"" (all)	Restrict to one star rating, "1"–"5".
includeImages	Boolean	true	Extract reviewer-uploaded images.
includeGdprSensitive	Boolean	false	Include reviewer name, profile link, and avatar.
country	String (select)	"amazon.com"	Amazon marketplace domain (19 supported, e.g. amazon.co.uk, amazon.de, amazon.in, amazon.com.br).
countryFallback	Boolean	true	When the requested marketplace returns no reviews, retry the same ASIN on amazon.ca then amazon.com.br. Ignored when cookieString is set or sourceMode is INLINE_ONLY.
cookieString	String	""	Optional Amazon session (the Cookie: header value from a logged-in browser). When set, enables deeper review history and the verified-purchases filter. Never paste your password here.
verifiedPurchasesOnly	Boolean	false	Only return Verified Purchase reviews. Requires cookieString; has no effect otherwise.
reviewerType	String (select)	""	Explicit reviewer-type filter mirroring Amazon's own parameter. Requires cookieString; leave empty to use verifiedPurchasesOnly instead.
cookieModeMaxReviews	Integer	500	Maximum reviews per product when cookieString is set (1–2000).
maxConcurrency	Integer	1	Concurrent page fetches (1–5).
requestTimeout	Integer	60	Per-page timeout in seconds (30–180).
retryCount	Integer	3	Retries on blocked/failed fetches (1–10).

Example: default review pull

{
    "productUrls": ["https://www.amazon.com/dp/B09X7MPX8L"],
    "maxReviews": 15,
    "sortBy": "helpful",
    "proxyConfiguration": { "useApifyProxy": true }
}

Example: discover products by keyword, 5-star only

{
    "keywords": ["wireless earbuds"],
    "maxProductsToDiscover": 5,
    "filterByStar": "5",
    "sortBy": "recent",
    "country": "amazon.co.uk",
    "proxyConfiguration": { "useApifyProxy": true }
}

Example: single marketplace, no fallback substitution

{
    "productUrls": ["B09X7MPX8L"],
    "sourceMode": "INLINE_ONLY",
    "countryFallback": false,
    "country": "amazon.de",
    "proxyConfiguration": { "useApifyProxy": true }
}

Example: extended history with your own session

{
    "productUrls": ["https://www.amazon.com/dp/B09X7MPX8L"],
    "cookieString": "session-id=123-4567890-1234567; ubid-main=123-4567890-1234567; at-main=Atza|...",
    "verifiedPurchasesOnly": true,
    "cookieModeMaxReviews": 500,
    "proxyConfiguration": { "useApifyProxy": true }
}

Use cases

• Voice-of-customer analysis — pull review text and ratings for a product line to feed sentiment or keyword analysis.
• Competitive benchmarking — compare averageRating, starsBreakdown, and "Customers say" summaries across competing ASINs.
• Review monitoring — schedule runs on a watch-list of products to track new reviews, ratings, and helpful-vote counts over time.
• Trust and quality signals — surface isVerified/isVineVoice flags and reviewer-uploaded media for product-quality dashboards.
• Localization research — compare review tone and content for the same product across different marketplace domains.
• Deeper brand research — supply your own cookieString for longer review history on products you have a legitimate reason to review in depth.

FAQ

How many reviews can I get per product by default? Up to maxReviews (max 15) from Amazon's own "Top reviews" section on the product page — typically around 8-13 reviews are available there per ASIN, since Amazon doesn't expose deeper pagination to anonymous visitors.

How do I get more than that? Supply your own Amazon session via cookieString. With a valid session, the actor can return up to cookieModeMaxReviews (default 500, max 2,000) per product and also supports the verified-purchases-only filter.

Why did my amazon.com run come back with reviews in French or Portuguese? When amazon.com returns no reviews for an ASIN and countryFallback is on (default), the actor retries the same ASIN on amazon.ca then amazon.com.br. Reviews recovered this way reflect that marketplace's language. Set countryFallback to false for strict single-marketplace matching.

Can I filter by verified purchases without a session? Not at fetch time — that filter requires cookieString. The isVerified flag is still returned on every review regardless, so you can filter it yourself downstream.

Can I get reviews in another language? Yes — set country to the corresponding domain (e.g. amazon.de for German); reviews come back in that storefront's language.

Why is collectionCompleteness present on some records? It's set to "INLINE_SAMPLE" only when sourceMode was FULL_PAGE, no valid cookieString was supplied, and onAuthRequired fell back to the default sample instead of failing — so you can tell those records aren't the deeper, paginated set.

Do reviewer name, profile, and avatar always appear? No — only when includeGdprSensitive is set to true. Make sure you have a lawful basis before enabling it.

Is this affiliated with Amazon? No. This is an independent, third-party actor that reads publicly available Amazon product and review pages and is not operated, endorsed, or sponsored by Amazon.com, Inc.