提交商品详情任务

接口说明

提交 Shopee 商品详情采集任务。

该接口只负责创建异步任务，不直接返回商品详情内容。提交成功后，请使用返回的 batch_id 调用查询接口轮询结果。

请求

GET /shopee-api/v1/submit-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，默认当前日期
priority	integer	否	任务优先级，默认 0，范围 0 到 100000
deadline	string(date-time)	否	任务截止时间，默认次日零点

请求示例

curl -G "https://api.bodapi.com/sp/v1/submit/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" \
  --data-urlencode "priority=10" \
  --data-urlencode "deadline=2026-03-24T00:00:00Z"

响应字段

字段	类型	说明
code	integer	业务状态码，0 表示提交成功
msg	string	返回消息
data.batch_id	string	任务批次 ID，后续查询结果时使用

响应示例

{
  "code": 0,
  "msg": "提交成功",
  "data": {
    "batch_id": "2026-03-23"
  }
}

补充说明

• 查询结果时建议继续携带相同的 shop_id、item_id、country，并带上返回的 batch_id。
• OpenAPI 未声明其他 HTTP 状态码，因此应以响应体中的 code 和 msg 作为主要判断依据。