---
document_id: agent.collection.task.amazon_product_reviews_v1
schema_version: 2
parent_document_id: agent.querying
section: querying
---

<!-- Generated by scripts.build_agent_guide; do not edit. -->

# Product reviews / 商品评论

Query stored Amazon reviews with optional date, single-star and verified-purchase filters. Reviews may belong to other listing variants; this does not start a live collection.

查询已收录的 Amazon 商品评论，可按日期、单个星级和购买验证筛选。评论可能属于同一 Listing 的其他变体，不触发实时采集。

Task / 任务: `amazon_product_reviews_v1`
Platform / 平台: Amazon / Amazon
Billing / 计费: 49 Credits per successful task / 每个成功任务 49 Credits
Estimate / 估价: call `estimate_collection`; start directly when `approval_required=false`, otherwise obtain approval for `upper_bound_credits`.
估价：调用 `estimate_collection`；`approval_required=false` 时直接启动，否则请用户确认 `upper_bound_credits`。

## Limitations / 限制

- One product or one page per request. Each successful request, including an empty page, is charged independently.
- Listing sales are estimates and may cover multiple variants. Published ASIN sales are not exact real-time sales.
- Amounts use the currency's minor unit; JPY has no fractional unit. Missing data is null, not zero.
- Stored reviews may be delayed and refer to other variants. No live review collection is started.
- 14 marketplaces are supported by the source contract; live verification is recorded separately.

## Inputs / 输入

- `country` — Country / marketplace / 国家/站点; kind=select; required=False; default='US'; allowed=US, GB, DE, FR, IN, CA, JP, ES, IT, MX, AE, AU, BR, SA
- `product` — ASIN or product URL / ASIN 或商品链接; kind=text; required=True; default=''; bounds=min_length=10, max_length=2048
- `since` — Reviews since (optional) / 评论起始日期（可选）; kind=text; required=False; default=''; bounds=min_length=0, max_length=10
- `star` — Star rating / 星级; kind=select; required=False; default='all'; allowed=all, 1, 2, 3, 4, 5
- `verified_purchase_only` — Verified purchases only / 仅已验证购买; kind=select; required=False; default='false'; allowed=false, true
- `page` — Page / 页码; kind=integer; required=False; default=1; bounds=min=1, max=10000

## Minimal call / 最小调用

`estimate_collection`

```json
{
  "task_query": "查询指定 Amazon 商品已收录的五星评论，并保留实际评论变体",
  "task_code": "amazon_product_reviews_v1",
  "input": {
    "product": "B08LYNQ8LC",
    "country": "US",
    "since": "2021-01-21",
    "star": "5",
    "page": 1
  }
}
```


## Result and pagination / 结果与分页

- mode=page
- current page: `data.page`; page bound: `data.max_page`; next page: `data.next_page` → `page` (null means stop). / 下一页使用 `data.next_page`，为 null 时结束；总页数未知不代表没有下一页。

Only the fields listed below are part of the stable result contract. /
只有下方列出的字段属于稳定结果契约。

## Result fields / 结果字段

- `meta.request_id` — type=string; Asklear request identifier for tracing. / 用于追踪的 Asklear 请求 ID。
- `meta.api_name` — type=string; Executed collection operation name. / 实际执行的采集操作名称。
- `meta.latency_ms` — type=integer; Collection execution latency in milliseconds. / 采集执行耗时（毫秒）。
- `meta.credits_charged` — type=integer; Asklear user-side Credits settled for this task after completion. / 任务完成后 Asklear 用户侧实际结算的 Credits。
- `data.country` — type=string; Marketplace: US, GB, DE, FR, IN, CA, JP, ES, IT, MX, AE, AU, BR or SA. Defaults to US. Source support does not imply every country was live-tested. / 国家站点：US、GB、DE、FR、IN、CA、JP、ES、IT、MX、AE、AU、BR、SA，默认 US。接口声明支持不等于各国已完成实测。
- `data.page` — type=integer; Requested page, starting at 1. One call purchases one page. / 本次请求的页码，从 1 开始，一次调用只获取一页。
- `data.next_page` — type=integer|null; Pass this as page with the same country and filters. For search, a full page only permits trying the next page; it does not guarantee more matches. Each successful page is charged, including an empty page. / 保持国家和筛选条件，将此值作为 page 继续查询。搜索满页仅表示可尝试下一页，不保证还有结果；每个成功页独立计费，包括成功空页。
- `data.max_page` — type=integer|null; Total pages when known. Search has no total and returns null; Playground does not enable its next-page button for an unknown total. / 已知时返回总页数，搜索无总数时为 null；总页数未知时 Playground 不启用下一页按钮。
- `data.total` — type=integer|null; Matching review count from the original page metadata; search returns null. / 原始分页元数据中的评论总数；搜索返回 null。
- `data.requested_asin` — type=string; ASIN requested. Individual reviews may refer to another variant in the same listing. / 请求的 ASIN；单条评论可能属于同一 Listing 下的其他变体。
- `data.items` — type=array<object>; Up to 100 stored review records. Review IDs may repeat across ASINs; preserve both. These are not guaranteed real-time reviews. collection_no_data means no stored reviews for the filters and no user charge. / 本页最多 100 条已收录评论，review_id 可能在不同 ASIN 间重复，应保留变体关系。评论不保证实时；collection_no_data 表示该条件下暂无已收录评论且不扣用户 Credits。
- `data.items[].review_id` — type=string; Public review ID; use together with asin as record identity. / 公开评论 ID，需与 asin 一起识别评论变体记录。
- `data.items[].asin` — type=string; Actual reviewed variant ASIN, which may differ from requested_asin. / 评论实际关联的变体 ASIN，可能与 requested_asin 不同。
- `data.items[].title` — type=string|null; Review title. / 评论标题。
- `data.items[].content` — type=string|null; Review text. / 评论正文。
- `data.items[].star` — type=integer|null; Review rating, 1–5; null if unavailable. / 1–5 星评分，未知为 null。
- `data.items[].date` — type=string|null; Date the review was posted, YYYY-MM-DD. / 用户留评日期（YYYY-MM-DD）。
- `data.items[].verified_purchase` — type=boolean|null; Whether Amazon marks this as a verified purchase. / 是否带 Amazon 已验证购买标记。
- `data.items[].collected_at` — type=string|null; Recorded update time as reported, without an assumed timezone; distinct from the review date. / 来源报告的收录更新时间，不擅自补时区，与用户留评日期不同。
- `data.items[].url` — type=string|null; Canonical public review link, without tracking or credential parameters. / 标准公开评论链接，不包含跟踪或凭证参数。

Use `list_collection_tasks` as the runtime authority, then `describe_collection_task` for one task's full input contract, examples and limits. Collection access is entitlement-gated. /
以 `list_collection_tasks` 返回为运行时准据，再用 `describe_collection_task` 取单个任务的完整入参契约、示例与限制；采集能力受 entitlement 控制。