Get Amazon customer reviews and a product-level rating summary by product URL, keyword, or category, with star-rating and sort filters, across 23 Amazon domains. Output fields: productAsin, ratingScor
Get Amazon customer reviews and a product-level rating summary by product URL, keyword, or category, with star-rating and sort filters, across 23 Amazon domains.
vexaloom-labs~amazon-customer-review-and-rating-summary-scraper)references/example-input.jsonreferences/input-schema.jsonreferences/output-fields.jsonShort video breakdown:
Use 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: ASINratingScore: RatingreviewTitle: TitlereviewDescription: Review DescriptionisVerified: VerifiedreviewedIn: Reviewed InreviewReaction: Review Reactionvariant: VariantreviewImages: Review ImagesreviewId: Review IDhelpfulCount: HelpfulreviewDate: DatereviewLocation: LocationsentimentHint: SentimentwordCount: WordshasImages: Has ImagesimageCount: Image CountreviewUrl: Review URLisVineVoice: VinereviewVideos: Review VideosAll 28 declared fields: references/output-fields.json.
| Field | Type | Required | Default | Notes |
|---|---|---|---|---|
| productUrls | array | no | | Amazon product URLs (/dp/, /gp/product/, /gp/aw/d/, /product/) or bare 10-character ASINs, on any supported Amazon domain. |
| keywords | array | no | [] | Search terms used to discover products when productUrls is empty (e.g. "wireless earbuds"). Each keyword contributes up to maxProductsToDiscover products. |
| categoryUrls | array | no | [] | Advanced discovery: Amazon /s?... search URLs or /b?node=... category URLs. Used only when productUrls is empty. |
| maxProductsToDiscover | integer | no | 5 | Maximum products discovered from each keyword or category URL (1-50). Ignored when productUrls is supplied. |
| country | string | no | amazon.com | Amazon storefront to use for bare ASINs, discovery, and products whose URL does not carry a domain. Product URLs keep their own domain. |
| maxReviews | integer | no | 100 | Hard cap per product after merging and deduplication (1-2000). The product-page sample alone yields about 8-13 rows; the optional extended feed can add 100-800+ for popular US… |
| extendedHistory | boolean | no | true | Merge Amazon's public extended review feed for each ASIN (no login): up to 100 rows per star/sort bucket, typically 100-800+ unique reviews for popular US products, deduplicated… |
| mergeMarketplaces | array | no | [] | Fetch the same product on these additional Amazon marketplaces and merge their deduplicated product-page reviews. Empty = the product's own marketplace only. |
| sortBy | string | no | helpful | Order of the returned reviews: most helpful first, or most recent first. |
| filterByStar | string | no | | Keep only reviews with this rating. positive keeps 4-5 stars and critical keeps 1-2 stars. Applied after merging, so narrow filters can legitimately return few or no rows. |
| verifiedPurchasesOnly | boolean | no | false | Keep only reviews carrying Amazon's Verified Purchase badge. Applied server-side in the extended feed (and cookie mode) 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 (YYYY-MM-DD or any ISO date). Reviews whose localized date cannot be parsed are kept. Empty = no date filter. |
| mediaReviewsOnly | boolean | no | false | Keep only reviews that include at least one reviewer-uploaded image or video. |
4 more optional fields on the Actor's Input tab.
Example:
{
"keywords": [
"wireless earbuds"
],
"country": "amazon.com",
"maxReviews": 100,
"includeAggregates": true
}
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/vexaloom-labs~amazon-customer-review-and-rating-summary-scraper/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/vexaloom-labs~amazon-customer-review-and-rating-summary-scraper/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.