Shopee 商品详情采集 API
基于异步任务机制提交并查询 Shopee 商品详情原始数据。
订阅此产品
pricing plan 属于当前 product，请在这里选择该产品下的套餐。
免费积分包Free
免费
包含 100 积分
- 计费模式：积分制套餐
- 100 积分
产品概览
Shopee 商品详情采集 API 采用异步任务模式。
- 第一步：调用提交接口创建采集任务，获取
batch_id - 第二步：调用查询接口轮询任务状态
- 第三步：当业务状态码
code = 0时，从data.source读取原始商品详情结果
基础信息
- Base URL：
https://api.bodapi.com - 认证方式：HTTP Header
X-API-Token: YOUR_API_TOKEN和X-API-Secret: YOUR_API_SECRET - 请求方式：
GET - 返回格式：
application/json - 版本：
sp/v1
调用流程
- 提交任务：
GET /sp/v1/submit/product_detail - 记录返回的
batch_id - 查询结果：
GET /sp/v1/query/product_detail - 当
code = 0时，任务完成；当code = -1时，任务仍在处理中；当code = -2时，任务执行异常
通用请求参数
| 参数 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| shop_id | query | string | 是 | Shopee 店铺 ID |
| item_id | query | string | 是 | Shopee 商品 ID |
| country | query | string | 是 | 站点代码：id / tw / vn / th / ph / my / sg / br / mx |
| X-API-Token | header | string | 是 | 固定不变的 API Token，用于身份识别、计费和限流 |
| X-API-Secret | header | string | 是 | 可轮换的 API Secret，用于凭证安全防护 |
通用响应结构
| 字段 | 类型 | 说明 |
|---|---|---|
| code | integer | 业务状态码；0 成功，负数表示未完成或异常 |
| msg | string | 服务端返回消息 |
| data | object | 业务数据对象 |
使用说明
- OpenAPI 规格里仅声明了 HTTP
200响应，实际成功、处理中、异常需通过code判断。 - 查询接口中的
data.source是上游返回的原始商品详情对象，字段体量较大，结构可能随上游变化。 - 如果提交接口未传
batch_id，文档说明默认使用当前日期作为批次标识。