Collect Amazon customer reviews and rating summaries by product URL, ASIN, or keyword across 19 marketplaces, with star-rating and sort filters, reviewer images, and an optional session for deeper rev
Collect Amazon customer reviews and rating summaries by product URL, ASIN, or keyword across 19 marketplaces, with star-rating and sort filters, reviewer images, and an optional session for deeper review history.
dataspryva~amazon-review-aggregates-and-extended-history)references/example-input.jsonreferences/input-schema.jsonreferences/output-fields.jsonUse this skill when the user wants:
Do not use it for private, login-protected or paywalled data.
One JSON row per result. Columns from the Actor's dataset schema:
productAsin: ASINreviewedProductAsin: Reviewed Product AsinratingScore: RatingreviewTitle: TitlereviewDescription: Review DescriptionisVerified: VerifiedisVineVoice: Is Vine VoicereviewedIn: Reviewed InreviewReaction: Review Reactionvariant: VariantreviewImages: Review ImagesreviewId: Review IDreviewUrl: Review UrlhelpfulCount: HelpfulreviewDate: DatereviewLocation: LocationsentimentHint: SentimentwordCount: WordshasImages: Has ImagesimageCount: Image CountAll 28 declared fields: references/output-fields.json.
| Field | Type | Required | Default | Notes |
|---|---|---|---|---|
| productUrls | array | no | | List of Amazon product URLs to scrape reviews from. Supports /dp/, /gp/product/, /gp/aw/d/ and /product/ URL formats across 19+ Amazon domains. A bare 10-character ASIN (e.g. |
| keywords | array | no | [] | Search keywords used to auto-discover products when productUrls is empty (e.g. "wireless earbuds"). |
| categoryUrls | array | no | [] | Advanced mode: supply your own Amazon /s?... or /b?node=... category/search URL(s) directly (used only when productUrls is empty). |
| maxProductsToDiscover | integer | no | 10 | Maximum number of products to discover per run from keywords/categoryUrls. Ignored when productUrls is supplied directly. |
| extendedHistory | boolean | no | true | Merge Amazon's public extended review feed for each ASIN (no login, no cookie): up to 100 reviews per star/sort bucket, and walking every bucket yields 100-850+ unique reviews for… |
| mergeMarketplaces | array | no | [] | Additional Amazon marketplaces whose product page is fetched for the same ASIN and whose reviews are merged (deduplicated by review ID and content). |
| includeAggregates | boolean | no | true | Emit one additional amazon_review_aggregate record per product with the product title, average rating, global ratings count, star histogram (plus derived per-star counts), and… |
| country | string | no | amazon.com | Amazon country domain to scrape from. URLs from a different domain are honored automatically. |
| maxReviews | integer | no | 100 | Hard cap on the number of reviews returned per product AFTER merging and deduplication (1-2000). |
| sortBy | string | no | helpful | How to sort the returned reviews: most helpful first, or most recent first. |
| filterByStar | string | no | | Keep only reviews with this rating. positive keeps 4-5 star reviews; critical keeps 1-2 star reviews. |
| verifiedPurchasesOnly | boolean | no | false | Keep only reviews carrying Amazon's Verified Purchase badge. Applied server-side for the extended feed and client-side for product-page rows. |
| filterKeywords | array | no | [] | Keep only reviews whose title or text contains at least one of these keywords (case-insensitive). Empty = no keyword filter. |
| reviewsNewerThan | string | no | | Keep only reviews dated on or after this date (e.g. 2026-01-15 or any ISO date). Reviews whose localized date cannot be parsed are kept. Empty = no date filter. |
3 more optional fields on the Actor's Input tab.
Example:
{
"keywords": [],
"categoryUrls": [],
"maxProductsToDiscover": 10,
"extendedHistory": true,
"mergeMarketplaces": [],
"includeAggregates": true,
"country": "amazon.com",
"maxReviews": 100,
"sortBy": "helpful",
"verifiedPurchasesOnly": false,
"filterKeywords": [],
"mediaReviewsOnly": false,
"includeImages": true,
"includeGdprSensitive": false,
"productUrls": [
"https://www.amazon.com/dp/B0EXAMPLE"
]
}
Set APIFY_TOKEN, then call the synchronous endpoint for small and medium runs (it waits up to 300 seconds):
curl -s -X POST "https://api.apify.com/v2/acts/dataspryva~amazon-review-aggregates-and-extended-history/run-sync-get-dataset-items" \
-H "Authorization: Bearer $APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d @references/example-input.json > output.json
Or with Node 18+: node scripts/run.mjs [input.json].
For large runs, start an async run and read its dataset when it finishes:
RUN=$(curl -s -X POST "https://api.apify.com/v2/acts/dataspryva~amazon-review-aggregates-and-extended-history/runs" \
-H "Authorization: Bearer $APIFY_TOKEN" -H "Content-Type: application/json" \
-d @references/example-input.json)
RUN_ID=$(echo "$RUN" | jq -r '.data.id'); DATASET=$(echo "$RUN" | jq -r '.data.defaultDatasetId')
curl -s "https://api.apify.com/v2/actor-runs/$RUN_ID?waitForFinish=60" -H "Authorization: Bearer $APIFY_TOKEN" | jq -r '.data.status'
curl -s "https://api.apify.com/v2/datasets/$DATASET/items?format=json" -H "Authorization: Bearer $APIFY_TOKEN" > output.json
Weekly roundup of top Claude Code skills, MCP servers, and AI coding tips.