查询商品详情任务结果

接口说明

查询 Shopee 商品详情任务结果。

该接口用于轮询异步任务状态。任务完成后，原始商品详情数据会出现在 data.source 中。

请求

GET /sp/v1/query/product_detail

请求头

参数	类型	必填	说明
X-API-Token	string	是	固定不变的 API Token，用于身份识别、计费和限流
X-API-Secret	string	是	可轮换的 API Secret，用于凭证安全防护

查询参数

参数	类型	必填	说明
shop_id	string	是	Shopee 店铺 ID
item_id	string	是	Shopee 商品 ID
country	string	是	站点代码：id / tw / vn / th / ph / my / sg / br / mx
batch_id	string	否	任务批次 ID；如果提交时有返回，建议原样带回

请求示例

curl -G "https://api.bodapi.com/sp/v1/query/product_detail" \
  -H "X-API-Token: YOUR_API_TOKEN" \
  -H "X-API-Secret: YOUR_API_SECRET" \
  --data-urlencode "shop_id=228694453" \
  --data-urlencode "item_id=46957555694" \
  --data-urlencode "country=tw" \
  --data-urlencode "batch_id=2026-03-23"

响应字段

顶层字段

字段	类型	说明
code	integer	业务状态码：0 成功，-1 进行中，-2 服务异常
msg	string	返回消息
data	object	结果对象

data 字段

字段	类型	说明
batch_id	string	批次 ID
source	object | null	原始商品详情结果对象；任务未完成或失败时可能为 null
crawled_at	string | null	采集完成时间
error	string | null	异常信息；成功时通常为 null

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "batch_id": "2026-03-23",
    "crawled_at": "2026-03-23 10:16:57",
    "error": null,
    "source": {
      "data": {
        "item": {
          "item_id": 46957555694,
          "shop_id": 228694453,
          "title": "（免運）臺灣出貨商品示例",
          "currency": "TWD",
          "attributes": [
            {
              "name": "材質",
              "value": "其他"
            }
          ]
        },
        "shop_detailed": {
          "shopid": 228694453,
          "name": "佳儷塑形衣坊",
          "rating_star": 4.759248
        }
      }
    }
  }
}

状态说明

code	含义
0	任务完成，可读取 data.source
-1	任务进行中，建议稍后继续轮询
-2	服务异常，可结合 data.error 和 msg 排查

补充说明

• data.source 是 OpenAPI 示例中返回的原始对象，字段很多，文档页建议只展示核心字段与示例，解析逻辑应容忍字段增减。
• 从示例看，原始结果通常包含商品主体、属性、评论、店铺信息等多个嵌套对象。