Amazon Customer Review & Rating Summary Scraper

{
  "description": "Collect Amazon customer reviews plus each product's rating summary with no login or proxy setup. Add product URLs/ASINs or discover products by keyword; reviews are merged and deduplicated, with optional extended history and filters.",
  "properties": {
    "categoryUrls": {
      "default": [],
      "description": "Advanced discovery: Amazon `/s?...` search URLs or `/b?node=...` category URLs. Used only when `productUrls` is empty.",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "prefill": [],
      "title": "Category or Search URLs (discover products)",
      "type": "array"
    },
    "cookieString": {
      "description": "Optional. Paste your own logged-in Amazon session cookie (the literal Cookie header value) to use paginated /product-reviews/ and unlock deeper history. Never required; the actor returns real public data without it. Never paste a password.",
      "editor": "textarea",
      "isSecret": true,
      "title": "Amazon Session Cookie (optional)",
      "type": "string"
    },
    "country": {
      "default": "amazon.com",
      "description": "Amazon storefront to use for bare ASINs, discovery, and products whose URL does not carry a domain. Product URLs keep their own domain.",
      "editor": "select",
      "enum": [
        "amazon.com",
        "amazon.co.uk",
        "amazon.de",
        "amazon.fr",
        "amazon.it",
        "amazon.es",
        "amazon.ca",
        "amazon.com.au",
        "amazon.co.jp",
        "amazon.in",
        "amazon.com.br",
        "amazon.com.mx",
        "amazon.nl",
        "amazon.sg",
        "amazon.ae",
        "amazon.sa",
        "amazon.pl",
        "amazon.se",
        "amazon.com.tr",
        "amazon.ie",
        "amazon.com.be",
        "amazon.co.za",
        "amazon.eg"
      ],
      "enumTitles": [
        "United States (amazon.com)",
        "United Kingdom (amazon.co.uk)",
        "Germany (amazon.de)",
        "France (amazon.fr)",
        "Italy (amazon.it)",
        "Spain (amazon.es)",
        "Canada (amazon.ca)",
        "Australia (amazon.com.au)",
        "Japan (amazon.co.jp)",
        "India (amazon.in)",
        "Brazil (amazon.com.br)",
        "Mexico (amazon.com.mx)",
        "Netherlands (amazon.nl)",
        "Singapore (amazon.sg)",
        "United Arab Emirates (amazon.ae)",
        "Saudi Arabia (amazon.sa)",
        "Poland (amazon.pl)",
        "Sweden (amazon.se)",
        "Turkey (amazon.com.tr)",
        "Ireland (amazon.ie)",
        "Belgium (amazon.com.be)",
        "South Africa (amazon.co.za)",
        "Egypt (amazon.eg)"
      ],
      "prefill": "amazon.com",
      "title": "Amazon Marketplace",
      "type": "string"
    },
    "extendedHistory": {
      "default": true,
      "description": "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 against the product-page sample. Coverage varies by ASIN and the feed carries Amazon.com reviews only.",
      "prefill": true,
      "title": "Extended Review History",
      "type": "boolean"
    },
    "filterByStar": {
      "default": "",
      "description": "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.",
      "editor": "select",
      "enum": [
        "",
        "1",
        "2",
        "3",
        "4",
        "5",
        "positive",
        "critical"
      ],
      "enumTitles": [
        "All Stars",
        "1 Star",
        "2 Stars",
        "3 Stars",
        "4 Stars",
        "5 Stars",
        "Positive (4-5 stars)",
        "Critical (1-2 stars)"
      ],
      "title": "Filter by Star Rating",
      "type": "string"
    },
    "filterKeywords": {
      "default": [],
      "description": "Keep only reviews whose title or text contains at least one of these keywords (case-insensitive). Empty = no keyword filter.",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "prefill": [],
      "title": "Filter by Keywords",
      "type": "array"
    },
    "includeAggregates": {
      "default": true,
      "description": "Emit one `amazon_review_aggregate` record per product with product title, average rating, global ratings count, star histogram, derived per-star counts, and Amazon's \"Customers say\" summary with aspects. The histogram is filled from the rating-summary popover when the page omits it.",
      "prefill": true,
      "title": "Include Rating Summary",
      "type": "boolean"
    },
    "includeGdprSensitive": {
      "default": false,
      "description": "Include reviewer display name, profile link, and avatar. Leave off for GDPR-sensitive workloads.",
      "prefill": false,
      "title": "Include Reviewer Names and Profiles",
      "type": "boolean"
    },
    "includeImages": {
      "default": true,
      "description": "Extract full-resolution image and video URLs uploaded by reviewers.",
      "prefill": true,
      "sectionCaption": "Output options",
      "sectionDescription": "Toggle optional fields. GDPR-sensitive reviewer identity is off by default.",
      "title": "Include Review Images and Videos",
      "type": "boolean"
    },
    "keywords": {
      "default": [],
      "description": "Search terms used to discover products when `productUrls` is empty (e.g. \"wireless earbuds\"). Each keyword contributes up to `maxProductsToDiscover` products.",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "prefill": [],
      "title": "Keywords (discover products)",
      "type": "array"
    },
    "maxProductsToDiscover": {
      "default": 5,
      "description": "Maximum products discovered from each keyword or category URL (1-50). Ignored when `productUrls` is supplied.",
      "editor": "number",
      "maximum": 50,
      "minimum": 1,
      "prefill": 5,
      "title": "Max Products to Discover",
      "type": "integer"
    },
    "maxReviews": {
      "default": 100,
      "description": "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 products. In optional cookie mode this is the paginated cap.",
      "editor": "number",
      "maximum": 2000,
      "minimum": 1,
      "prefill": 15,
      "sectionCaption": "Review collection",
      "sectionDescription": "Control review depth and which public sources are merged.",
      "title": "Max Reviews per Product",
      "type": "integer"
    },
    "mediaReviewsOnly": {
      "default": false,
      "description": "Keep only reviews that include at least one reviewer-uploaded image or video.",
      "prefill": false,
      "title": "Media Reviews Only",
      "type": "boolean"
    },
    "mergeMarketplaces": {
      "default": [],
      "description": "Fetch the same product on these additional Amazon marketplaces and merge their deduplicated product-page reviews. Empty = the product's own marketplace only.",
      "editor": "select",
      "items": {
        "enum": [
          "amazon.com",
          "amazon.co.uk",
          "amazon.de",
          "amazon.fr",
          "amazon.it",
          "amazon.es",
          "amazon.ca",
          "amazon.com.au",
          "amazon.co.jp",
          "amazon.in",
          "amazon.com.br",
          "amazon.com.mx",
          "amazon.nl",
          "amazon.sg",
          "amazon.ae",
          "amazon.sa",
          "amazon.pl",
          "amazon.se",
          "amazon.com.tr",
          "amazon.ie",
          "amazon.com.be",
          "amazon.co.za",
          "amazon.eg"
        ],
        "enumTitles": [
          "United States (amazon.com)",
          "United Kingdom (amazon.co.uk)",
          "Germany (amazon.de)",
          "France (amazon.fr)",
          "Italy (amazon.it)",
          "Spain (amazon.es)",
          "Canada (amazon.ca)",
          "Australia (amazon.com.au)",
          "Japan (amazon.co.jp)",
          "India (amazon.in)",
          "Brazil (amazon.com.br)",
          "Mexico (amazon.com.mx)",
          "Netherlands (amazon.nl)",
          "Singapore (amazon.sg)",
          "United Arab Emirates (amazon.ae)",
          "Saudi Arabia (amazon.sa)",
          "Poland (amazon.pl)",
          "Sweden (amazon.se)",
          "Turkey (amazon.com.tr)",
          "Ireland (amazon.ie)",
          "Belgium (amazon.com.be)",
          "South Africa (amazon.co.za)",
          "Egypt (amazon.eg)"
        ],
        "type": "string"
      },
      "prefill": [],
      "title": "Merge Extra Marketplaces",
      "type": "array"
    },
    "productUrls": {
      "description": "Amazon product URLs (/dp/, /gp/product/, /gp/aw/d/, /product/) or bare 10-character ASINs, on any supported Amazon domain. Leave empty to discover products from `keywords`/`categoryUrls` instead.",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "prefill": [
        "https://www.amazon.com/dp/B09X7MPX8L"
      ],
      "sectionCaption": "Products",
      "sectionDescription": "Scrape these products, or leave empty and discover products by keyword or category.",
      "title": "Product URLs or ASINs",
      "type": "array"
    },
    "reviewsNewerThan": {
      "default": "",
      "description": "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.",
      "editor": "datepicker",
      "prefill": "",
      "title": "Reviews Newer Than",
      "type": "string"
    },
    "sortBy": {
      "default": "helpful",
      "description": "Order of the returned reviews: most helpful first, or most recent first.",
      "editor": "select",
      "enum": [
        "helpful",
        "recent"
      ],
      "enumTitles": [
        "Most Helpful",
        "Most Recent"
      ],
      "prefill": "helpful",
      "title": "Sort Reviews By",
      "type": "string"
    },
    "verifiedPurchasesOnly": {
      "default": false,
      "description": "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.",
      "prefill": false,
      "title": "Verified Purchases Only",
      "type": "boolean"
    }
  },
  "schemaVersion": 1,
  "title": "Amazon Customer Review & Rating Summary Scraper Input",
  "type": "object"
}

{
  "actorOutputSchemaVersion": 1,
  "description": "One record per Amazon customer review (rating, text, verified/Vine flags, helpful votes, variant, media, dates, source metadata) plus one type=amazon_review_aggregate record per product with the rating summary and star histogram. Empty fields are omitted, never pushed as null.",
  "properties": {
    "reviews": {
      "description": "Dataset containing all scraped Amazon customer reviews.",
      "template": "{{links.apiDefaultDatasetUrl}}/items",
      "title": "Amazon reviews",
      "type": "string"
    }
  },
  "title": "Amazon Customer Review & Rating Summary Scraper Output"
}

{
  "actorSpecification": 1,
  "title": "Amazon Reviews",
  "views": {
    "reviews": {
      "display": {
        "component": "table",
        "properties": {
          "hasImages": {
            "format": "boolean",
            "label": "Has Images"
          },
          "helpfulCount": {
            "format": "number",
            "label": "Helpful"
          },
          "isVerified": {
            "format": "boolean",
            "label": "Verified"
          },
          "isVineVoice": {
            "format": "boolean",
            "label": "Vine"
          },
          "productAsin": {
            "format": "text",
            "label": "ASIN"
          },
          "ratingScore": {
            "format": "number",
            "label": "Rating"
          },
          "reviewDate": {
            "format": "text",
            "label": "Date"
          },
          "reviewHash": {
            "format": "text",
            "label": "Review Hash"
          },
          "reviewId": {
            "format": "text",
            "label": "Review ID"
          },
          "reviewLocation": {
            "format": "text",
            "label": "Location"
          },
          "reviewTitle": {
            "format": "text",
            "label": "Title"
          },
          "reviewUrl": {
            "format": "text",
            "label": "Review URL"
          },
          "sentimentHint": {
            "format": "text",
            "label": "Sentiment"
          },
          "source": {
            "format": "text",
            "label": "Source"
          },
          "sourceMarketplace": {
            "format": "text",
            "label": "Marketplace"
          },
          "wordCount": {
            "format": "number",
            "label": "Words"
          }
        }
      },
      "title": "Reviews",
      "transformation": {
        "fields": [
          "productAsin",
          "ratingScore",
          "reviewTitle",
          "reviewDescription",
          "isVerified",
          "reviewedIn",
          "reviewReaction",
          "variant",
          "reviewImages",
          "position",
          "reviewId",
          "helpfulCount",
          "reviewDate",
          "reviewLocation",
          "sentimentHint",
          "wordCount",
          "hasImages",
          "imageCount",
          "scrapedAt",
          "sourceUrl",
          "reviewUrl",
          "isVineVoice",
          "reviewVideos",
          "hasVideos",
          "reviewHash",
          "source",
          "sourceMarketplace",
          "reviewedProductAsin"
        ]
      }
    }
  }
}