抖音电商获取团购商品详情

POST🔗 /api/douyin-ec/groupbuy-item-detail-v1🔒 需开通

抖音电商团购本地生活

🔒

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

根据门店 poi_id 与团购 item_id 获取团购商品详情。

请求参数

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

代码示例

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

cURL

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

Python

import requests

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

Node.js

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

响应结果示例

成功响应

{
  "code": 0,
  "message": "ok",
  "data": {
    "poi_id": "poi_001",
    "item_id": "g_1",
    "title": "双人套餐",
    "price": "99.00",
    "original_price": "198.00",
    "includes": [
      "主菜 x2",
      "饮品 x2"
    ]
  }
}

错误响应

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