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

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

# Product detail / 商品详情

Get one public Xianyu second-hand product detail by item ID.

按商品 ID 获取一个闲鱼二手商品公开详情。

Task / 任务: `xianyu_product_detail_v1`
Platform / 平台: Xianyu / 闲鱼
Billing / 计费: 48 Credits per successful task / 每个成功任务 48 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 fixed marketplace data route is called per task; no automatic version fallback or cross-platform fan-out is performed.
- 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.
- Production exposure requires the configured marketplace data connection and bounded live acceptance evidence.

## Inputs / 输入

- `item_id` — Item ID / 商品 ID; kind=text; required=True; default=''; bounds=min_length=1, max_length=256

## Minimal call / 最小调用

`estimate_collection`

```json
{
  "task_query": "查询指定闲鱼商品详情",
  "task_code": "xianyu_product_detail_v1",
  "input": {
    "item_id": "<搜索结果返回的 item_id>"
  }
}
```


## Result and pagination / 结果与分页

- mode=none

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.item` — type=object|null; Projected public detail, or null when absent. / 投影后的公开详情；不存在时为 null。
- `data.item.item_id` — type=scalar|null; Product identifier, when available. / 商品 ID（如有）。
- `data.item.title` — type=scalar|null; Title, when available. / 标题（如有）。
- `data.item.url` — type=scalar|null; Public URL, when available. / 公开链接（如有）。
- `data.item.price` — type=string|number|object|null; Price, when available. / 价格（如有）。
- `data.item.currency` — type=scalar|null; Currency, when available. / 币种（如有）。
- `data.item.image` — type=scalar|null; Image, when available. / 图片（如有）。
- `data.item.images` — type=array<object>|null; Product images, when available. / 商品图片（如有）。
- `data.item.sales` — type=scalar|null; Sales information, when available. / 销量信息（如有）。
- `data.item.seller_id` — type=scalar|null; Seller identifier, when available. / 卖家 ID（如有）。
- `data.item.seller_name` — type=scalar|null; Seller name, when available. / 卖家名称（如有）。
- `data.item.shop_url` — type=scalar|null; Shop URL, when available. / 店铺链接（如有）。
- `data.item.rating` — type=scalar|null; Rating, when available. / 评分（如有）。
- `data.item.description` — type=scalar|null; Description, when available. / 描述（如有）。
- `data.item.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 控制。