按 ASIN 或商品链接提取 Amazon 评论

{
  "type": "object",
  "required": [
    "body"
  ],
  "properties": {
    "body": {
      "type": "object",
      "title": "Extract product reviews from Amazon using product IDs or URLs, including titles, review text, date, and more.",
      "required": [
        "products"
      ],
      "properties": {
        "sort": {
          "enum": [
            "helpful",
            "recent"
          ],
          "type": "string",
          "title": "Sort by",
          "default": "helpful",
          "enumTitles": [
            "Top reviews",
            "Most recent"
          ],
          "description": "可选，默认为 helpful，请求来源排列的热门评论。recent 请求较新的评论，不保证按最新排序或完整覆盖。"
        },
        "limit": {
          "type": "integer",
          "unit": "page",
          "title": "pages to scrape per product",
          "default": 20,
          "maximum": 50,
          "minimum": 1,
          "description": "可选，每个商品的页数上限为 1–50，默认 20。来源的单个评论视图可能限于 10 页，因此提高设置不保证取得更多记录。页数不是评论数量，也不是整次请求的总上限。"
        },
        "stars": {
          "type": "array",
          "items": {
            "enum": [
              "five_star",
              "four_star",
              "three_star",
              "two_star",
              "one_star"
            ],
            "type": "string",
            "enumTitles": [
              "5 star",
              "4 star",
              "3 star",
              "2 star",
              "1 star"
            ]
          },
          "title": "Filter multiple stars",
          "editor": "select",
          "description": "可选，可选择一个或多个星级视图，具体值见单项星级说明。组合视图可能重叠，不保证评论不重复或完整覆盖。"
        },
        "rating": {
          "enum": [
            "all",
            "five_star",
            "four_star",
            "three_star",
            "two_star",
            "one_star",
            "positive",
            "critical"
          ],
          "type": "string",
          "title": "Rating stars",
          "default": "all",
          "enumTitles": [
            "All",
            "5 star",
            "4 star",
            "3 star",
            "2 star",
            "1 star",
            "Positive only",
            "Critical only"
          ],
          "description": "可选，默认为 all。可选择 five_star 至 one_star 中的单一星级，或来源定义的 positive、critical 组；这些组并未独立分析情绪或质量。组合星级选项或链接设置时，不要假定某项一定优先。",
          "sectionCaption": "Filters for more reviews",
          "sectionDescription": "These filters apply to the provided ASINs. Filters for product URLs are automatically detected. Use a combination of these filters to retrieve thousands of reviews; note that some duplicate reviews may be returned."
        },
        "region": {
          "enum": [
            "amazon.com",
            "amazon.ca",
            "amazon.de",
            "amazon.fr",
            "amazon.co.uk",
            "amazon.it",
            "amazon.es",
            "amazon.com.au",
            "amazon.co.jp",
            "amazon.com.br",
            "amazon.com.mx",
            "amazon.nl",
            "amazon.ie",
            "amazon.se",
            "amazon.com.tr",
            "amazon.ae",
            "amazon.sg",
            "amazon.sa",
            "amazon.pl",
            "amazon.com.be",
            "amazon.eg",
            "amazon.in"
          ],
          "type": "string",
          "title": "Amazon ASINs domain",
          "default": "amazon.com",
          "enumTitles": [
            "United States (amazon.com)",
            "Canada (amazon.ca)",
            "Germany (amazon.de)",
            "France (amazon.fr)",
            "United Kingdom (amazon.co.uk)",
            "Italy (amazon.it)",
            "Spain (amazon.es)",
            "Australia (amazon.com.au)",
            "Japan (amazon.co.jp)",
            "Brazil (amazon.com.br)",
            "Mexico (amazon.com.mx)",
            "Netherlands (amazon.nl)",
            "Ireland (amazon.ie)",
            "Sweden (amazon.se)",
            "Turkey (amazon.com.tr)",
            "United Arab Emirates (amazon.ae)",
            "Singapore (amazon.sg)",
            "Saudi Arabia (amazon.sa)",
            "Poland (amazon.pl)",
            "Belgium (amazon.com.be)",
            "Egypt (amazon.eg)",
            "India (amazon.in)"
          ],
          "description": "可选，为单独提供的 ASIN 选择所列 Amazon 域名，默认为 amazon.com。链接可能自带站点和筛选设置。站点选择不翻译评论，也不验证评论者所在地。",
          "sectionCaption": "Domain & Language"
        },
        "end_date": {
          "type": "string",
          "title": "End date",
          "editor": "datepicker",
          "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$",
          "description": "可选，包含结束日，请求日期不晚于该 YYYY-MM-DD 日期的评论。它指评论发布而非采集时间，未设默认日期，也未指定时区。"
        },
        "keywords": {
          "type": "array",
          "title": "Filter by keywords",
          "editor": "stringList",
          "description": "可选，填写互不重复的评论关键词以缩小返回范围。不保证多词按全部包含或任一包含的特定规则匹配。",
          "uniqueItems": true
        },
        "language": {
          "enum": [
            "all",
            "en",
            "es",
            "fr",
            "de",
            "pt",
            "it",
            "nl",
            "pl",
            "sv",
            "cs",
            "zh_CN",
            "zh_TW",
            "ja",
            "ko",
            "ar",
            "tr"
          ],
          "type": "string",
          "title": "Reviews language",
          "default": "all",
          "enumTitles": [
            "All languages",
            "English (en)",
            "Spanish (es)",
            "French (fr)",
            "German (de)",
            "Portuguese (pt)",
            "Italian (it)",
            "Dutch (nl)",
            "Polish (pl)",
            "Swedish (sv)",
            "Czech (cs)",
            "Simplified Chinese (zh-CN)",
            "Traditional Chinese (zh-TW)",
            "Japanese (ja)",
            "Korean (ko)",
            "Arabic (ar)",
            "Turkish (tr)"
          ],
          "description": "可选，默认为 all。选择所列语言以筛选对应语言的评论；该设置不翻译正文。"
        },
        "products": {
          "type": "array",
          "title": "Start ASINs/URLs",
          "editor": "stringList",
          "prefill": [
            "https://www.amazon.com/Logitech-LIGHTSPEED-Wireless-Gaming-Mouse/product-reviews/B07CMS5Q6P/ref=cm_cr_getr_mb_paging_btm_2?ie=UTF8&reviewerType=all_reviews&pageNumber=2&formatType=current_format",
            "B07MVJZQTC"
          ],
          "description": "必填，填写互不重复的已选商品 ASIN、商品链接或商品评论页链接。单独 ASIN 使用所选站点；链接可能自带域名和筛选条件，不要假定 ASIN 选项会覆盖它们。预填目标只是示例，不是默认值。",
          "uniqueItems": true
        },
        "all_stars": {
          "type": "boolean",
          "title": "All Stars Mode (up to 500 review per product)",
          "default": false,
          "description": "可选，默认为 false。开启时请求跨星级视图采集，视图可能重叠，不保证返回 500 条评论、不重复记录或完整历史。",
          "sectionCaption": "Scraping Modes"
        },
        "start_date": {
          "type": "string",
          "title": "Start date",
          "editor": "datepicker",
          "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$",
          "description": "可选，包含开始日，请求日期不早于该 YYYY-MM-DD 日期的评论。它指评论发布而非采集时间，未设默认日期，也未指定时区。",
          "sectionCaption": "Filter by Date range",
          "sectionDescription": "Filter reviews by date range. This option is useful for scraping reviews from a specific period. \nNOTE: You are charged per review scraped, so using date filter will not lower the cost."
        },
        "avp_reviews": {
          "type": "boolean",
          "title": "Only verified purchase",
          "default": false,
          "description": "可选，默认为 false。设为 true 时仅请求带来源已验证购买标记的评论；该标记不是独立买家身份或评论真实性核查。",
          "groupCaption": "Options"
        },
        "personal_data": {
          "type": "boolean",
          "title": "Include personal data",
          "default": false,
          "description": "可选，默认为 false。开启时请求可用的评论者姓名、标识符等个人字段；可用情况不同，不保证提供或验证联系方式，该设置也不保证完全匿名化。"
        },
        "include_variants": {
          "type": "boolean",
          "title": "Include all variants reviews",
          "default": true,
          "description": "可选，默认为 true，控制是否纳入商品变体评论视图。覆盖范围取决于来源，可能重叠，不保证每个变体的完整历史。"
        },
        "scrape_image_reviews": {
          "type": "boolean",
          "title": "Scrape reviews with images",
          "default": true,
          "description": "可选，默认为 true，请求含图片的评论；这类记录可能字段有限或与其他视图重叠，不会下载图片。关闭此项不保证普通评论记录没有图片地址。",
          "groupCaption": "Media reviews",
          "sectionCaption": "Scrape media reviews (more reviews)",
          "sectionDescription": "Scrape reviews that contain media (images/videos). This option is useful for extracting visual content from reviews. \nScraping media reviews can significantly increase the number of reviews returned, especially for products with rich media content. \nMedia reviews might return limited data."
        },
        "scrape_video_reviews": {
          "type": "boolean",
          "title": "Scrape reviews with videos",
          "default": true,
          "description": "可选，默认为 true，请求含视频的评论；这类记录可能字段有限或与其他视图重叠，不会下载视频。关闭此项不保证普通评论记录没有视频地址。"
        }
      },
      "description": "必填，请求对象包含已选商品和可选的评论采集设置。实际覆盖范围取决于所选评论视图、筛选条件及来源访问情况。",
      "schemaVersion": 1
    }
  },
  "additionalProperties": false
}