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

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

# Product reviews / 商品评价

Get one page of Taobao or Tmall product reviews from the live comment source, with a bounded fallback when available.

从实时评论来源分页获取淘宝或天猫商品评价；来源异常时，在已配置备用来源的情况下有限 fallback。

Task / 任务: `taobao_product_reviews_v3`
Platform / 平台: Taobao/Tmall / 淘宝/天猫
Billing / 计费: 11 Credits per successful task / 每个成功任务 11 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 / 限制

- The live comment source is tried first for this task; if it fails, one bounded fallback is attempted when the backup source is configured.
- Returned data is bounded and projected into task-specific public fields; missing fields are not inferred.
- Each successful request is charged once by the configured Asklear task price; the internal fallback does not add a second customer charge.
- Production exposure requires the configured marketplace data connection and bounded live acceptance evidence.

## Inputs / 输入

- `product_id` — Product ID / 商品 ID; kind=text; required=True; default=''; bounds=min_length=1, max_length=256
- `page_no` — Page / 页码; kind=integer; required=False; default=1; bounds=min=1, max=1000
- `has_rate` — Include default reviews / 是否返回默认评论; kind=select; required=False; default='1'; allowed=0, 1

## Minimal call / 最小调用

`estimate_collection`

```json
{
  "task_query": "查询指定淘宝或天猫商品评价",
  "task_code": "taobao_product_reviews_v3",
  "input": {
    "product_id": "<淘宝商品搜索返回的 product_id>",
    "page_no": 1,
    "has_rate": "1"
  }
}
```


## Result and pagination / 结果与分页

- mode=page
- current page: `data.page`; page bound: `data.max_page`; next page: `data.next_page` → `page_no` (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.items` — type=array<object>; Review records returned by this page. / 本页返回的评论记录。
- `data.page` — type=integer; Current review page, starting at 1. / 当前评论页码，从 1 开始。
- `data.max_page` — type=integer|null; Total review pages when reported. / 来源提供时返回评论总页数。
- `data.next_page` — type=integer|null; Next page number when another review page is available. / 还有下一页评论时返回下一页页码。
- `data.total` — type=integer|null; Total review count when reported. / 来源提供时返回评论总数。
- `data.items[].review_id` — type=string|integer|null; Public review identifier. / 公开评论 ID。
- `data.items[].item_id` — type=string|integer|null; Reviewed product identifier when supplied. / 如来源提供则返回被评论商品 ID。
- `data.items[].author_name` — type=string|null; Review author display name when supplied. / 如来源提供则返回评论者名称。
- `data.items[].content` — type=string|null; Review text when supplied. / 如来源提供则返回评论正文。
- `data.items[].rating` — type=scalar|null; Review rating when supplied. / 如来源提供则返回评论评分。
- `data.items[].created_at` — type=string|integer|null; Review creation time when supplied. / 如来源提供则返回评论时间。
- `data.items[].verified_purchase` — type=boolean|null; Whether the source marks the review as verified. / 来源是否标记为已验证购买。
- `data.items[].like_count` — type=integer|null; Review like or helpful count when supplied. / 如来源提供则返回评论点赞或有用数。
- `data.items[].url` — type=string|null; Safe public review URL when supplied. / 如来源提供则返回安全的公开评论链接。
- `data.items[].images` — type=array<string>; Safe public review image URLs when supplied. / 如来源提供则返回安全的评论图片链接。
- `data.items[].extended_data` — type=object; Sanitized business extensions; nested keys vary by product and source. / 安全清洗后的业务扩展字段；内部键随商品和来源变化。
- `data.extended_data` — type=object; Sanitized page-level business extensions, when available. / 安全清洗后的页级业务扩展字段（如有）。

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 控制。