# 读取商品搜索结果

读取商品搜索结果

ID: products:status · Region: cn · Status: available

catalog_version: 5c920c774a55e44d7e8c709143b88a18b8b2afcef91a5d19a8c9ae5d565d9077
updated_at: 2026-10-21T12:06:16.523771+00:00

读取商品搜索结果

历史数据以数据集发布版本定义覆盖周期；实时读取反映请求时资料，不保证覆盖全部记录。

Docs: https://docs.asklear.cn/capabilities/products%3Astatus

## GET /v1/search_products/{query_id}

legacy · available · api_key, oauth

REST 需要客户 API Key；MCP 需要已开放的服务及现有授权；CLI 需要已发布且包含该命令的客户端。



执行遵循现有计价；读取公开说明不扣 Credits。

请求声明 idempotency_key 时，同一次操作复用原键；元数据 GET 只读。

等待态响应提供结果/状态引用。先读取原结果；超时或结果不明时禁止自动重新提交付费执行。401/403/422 应先修正鉴权、权限或输入。

### Input schema / 输入契约

```json
{
  "additionalProperties": false,
  "properties": {
    "query_id": {
      "type": "string"
    }
  },
  "required": [
    "query_id"
  ],
  "type": "object"
}
```

### Synthetic request / 合成请求

```json
{
  "query_id": "product-search-example"
}
```

### Synthetic response / 合成响应

```json
{
  "data": [],
  "status": "succeeded"
}
```

- status (string): 暂无字段说明
- data (array<object>): 暂无字段说明
