淘宝和天猫获取商品详情

POST🔗 /api/taobao/item-detail-v1🔒 需开通

淘宝商品

🔒

该接口需开通后调用暂未开放自助调用。联系销售为你的账号开通权限并发放调用 token。

根据商品 ID 获取标题、价格、销量、主图等信息。

请求参数

参数名	类型	必填	默认值	说明
token	string	是	-	你的访问令牌（通过 query 传递）
item_id	string	是	-	商品 ID

代码示例

环境地址：示例中的 https://<your_endpoint> 为占位符，请替换为客服为你分配的专属接入地址（详见快速开始）。

cURL

curl -X POST 'https://<your_endpoint>/api/taobao/item-detail-v1?token=YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"item_id":"1234567890"}'

Python

import requests

resp = requests.post(
    "https://<your_endpoint>/api/taobao/item-detail-v1",
    params={"token": "YOUR_TOKEN"},
    json={
      "item_id": "1234567890"
    },
    timeout=60,
)
print(resp.json())

Node.js

const resp = await fetch('https://<your_endpoint>/api/taobao/item-detail-v1?token=YOUR_TOKEN', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({"item_id":"1234567890"}),
})
console.log(await resp.json())

响应结果示例

成功响应

{
  "code": 0,
  "message": "ok",
  "data": {
    "item_id": "1234567890",
    "title": "示例商品",
    "price": "99.00",
    "sales": 5230,
    "shop": "示例旗舰店"
  }
}

错误响应

{
  "code": 303,
  "message": "采集失败，请稍后重试",
  "data": null
}