{
  "title": "Amazon Reviews",
  "type": "object",
  "schemaVersion": 1,
  "properties": {
    "asins": {
      "title": "ASINs or product URLs",
      "type": "array",
      "description": "Verified UK example: [\"https://www.amazon.co.uk/dp/B09G9FPHY6\"]. Current US tests require sign-in and return no reviews. A URL selects its marketplace; bare ASINs use domain (default com). Only source-visible product-page samples, not full history or a guaranteed count. Each ASIN + marketplace is fetched and billed once. Blocked pages have a free error status.",
      "editor": "stringList",
      "prefill": [
        "https://www.amazon.co.uk/dp/B09G9FPHY6"
      ],
      "default": [],
      "uniqueItems": true,
      "sectionCaption": "What to scrape"
    },
    "domain": {
      "title": "Marketplace",
      "type": "string",
      "description": "Marketplace for bare ASINs; runtime default \"com\" means amazon.com, whose current tested review pages require sign-in. A full UK URL such as \"https://www.amazon.co.uk/dp/B09G9FPHY6\" selects co.uk automatically and ignores this field. The parser accepts 20 marketplace codes listed in the README; current anonymous availability is not guaranteed for all of them. Reviews retain the source language; no language filter or translation.",
      "editor": "textfield",
      "default": "com"
    },
    "minRating": {
      "title": "Only reviews at or below this rating",
      "type": "integer",
      "description": "Star CEILING, not a floor: keeps only reviews rated at or BELOW this many stars, e.g. 2 = one- and two-star reviews only, 3 = three stars and below. 0 (default) = every rating. Use for \"negative reviews\", \"complaints\", \"what do customers dislike\". The filter selects within the visible product-page sample, so a negative-only run returns a few rows per product and none when no visible review is negative. Dropped reviews are never charged; the product row is still delivered.",
      "editor": "number",
      "minimum": 0,
      "maximum": 5,
      "default": 0,
      "sectionCaption": "Which reviews (filters run before billing)"
    },
    "verifiedOnly": {
      "title": "Only verified purchases",
      "type": "boolean",
      "description": "true = keep only reviews Amazon marks as Verified Purchase. Default false (every review). Dropped reviews are never charged. Use for \"verified purchase reviews only\".",
      "editor": "checkbox",
      "default": false
    },
    "requireText": {
      "title": "Only reviews with written text",
      "type": "boolean",
      "description": "true = drop rating-only reviews without written text before billing. Runtime default false; the first-call form prefills true for a useful text sample. Use for sentiment analysis or topic mining. Filtered reviews are never charged.",
      "editor": "checkbox",
      "default": false,
      "prefill": true
    },
    "includeProductRow": {
      "title": "Include a product row",
      "type": "boolean",
      "description": "true (DEFAULT) = one extra row per product at $0.003 with its overall rating, ratings count, 5-to-1-star histogram (when Amazon shows it), title, brand, availability, image, feature bullets and reviews_visible. Keep it for \"rating and review count for these ASINs\" and catalogue-wide rating sweeps. Set false to pay for review rows only.",
      "editor": "checkbox",
      "default": true,
      "sectionCaption": "Rows and caps"
    },
    "maxReviewsPerProduct": {
      "title": "Max reviews per product",
      "type": "integer",
      "description": "0 (runtime default) = all source-visible reviews. The form prefills 3 for a small UK sample. N caps rows per product after free filters, in source order; fewer may be available. Three reviews cost at most $0.015, plus $0.003 if includeProductRow is true. Setting 1 still returns one eligible review plus the optional product row; it is not a product-only switch. No sort, date or only-new control; dedupe on review_id.",
      "editor": "number",
      "minimum": 0,
      "maximum": 13,
      "default": 0,
      "prefill": 3
    },
    "sessions": {
      "title": "Parallel sessions",
      "type": "integer",
      "description": "Parallel proxy sessions (one egress IP each), 1 to 16, e.g. 4 (default 4). More is faster for long ASIN lists; each session is paced separately.",
      "editor": "number",
      "minimum": 1,
      "maximum": 16,
      "default": 4,
      "sectionCaption": "Proxy and pacing"
    },
    "perIp": {
      "title": "Requests per second per IP",
      "type": "number",
      "description": "Requests per second per session, 0.1 to 2 (default 0.5). Amazon tolerates about 0.5/s per IP; faster causes captchas, not speed. Leave the default.",
      "editor": "number",
      "minimum": 0.1,
      "maximum": 2,
      "default": 0.5
    },
    "proxyConfiguration": {
      "title": "Proxy",
      "type": "object",
      "description": "Apify Proxy defaults to {\"useApifyProxy\":true}; the run can retry transient blocks and escalate to residential routing. Rotation does not guarantee access when Amazon requires sign-in. The verified UK examples work with the default proxy setup. To request residential directly: {\"useApifyProxy\":true,\"apifyProxyGroups\":[\"RESIDENTIAL\"]}. Input prices and billing rules are unchanged.",
      "editor": "proxy",
      "default": {
        "useApifyProxy": true
      }
    }
  },
  "required": [],
  "description": "UK first call: {\"asins\":[\"https://www.amazon.co.uk/dp/B09G9FPHY6\"],\"maxReviewsPerProduct\":3,\"requireText\":true}. US pages currently require sign-in and return no reviews. Only visible product-page samples, not full history. Review rows cost $0.005 each; includeProductRow defaults to true and adds a $0.003 product row. Filters run before billing. API defaults are unchanged."
}
