返回 TikTok 红人在内容中挂过的全部商品,含商品信息和归因于该红人的销量。属于高消耗的电商接口。
GET
/api/v1/tiktok/user/shop/goods/list额度扣减: 本接口每次成功请求会从套餐额度中扣减 10 单位。
请求参数
必填参数
| 名称 | 位置 | 类型 | 说明 |
|---|---|---|---|
unique_id | query | string | unique_id example: popmart.usshop |
可选参数
| 名称 | 位置 | 类型 | 说明 |
|---|---|---|---|
page | query | integer | Page number |
响应字段
| 名称 | 类型 | 说明 |
|---|---|---|
success | boolean | Success |
code | integer | Code |
message | string | Message |
data | object | - |
data.items | array<object> | Items |
data.total | integer | Total |
data.page | integer | Page |
data.page_size | integer | Page Size |
data.total_pages | integer | Total Pages |
在线调试
https://openapi.scdata.cc/api/v1/tiktok/user/shop/goods/list
请先从 Dashboard 选择一个 API key
发送请求前请先准备一个 API key。前往 Dashboard
查询参数
unique_id*pagecURL 示例
bash
curl -X GET "https://openapi.scdata.cc/api/v1/tiktok/user/shop/goods/list?unique_id=popmart.usshop" \-H "Authorization: YOUR_API_KEY"
响应示例 (200 application/json)
json
{"success": true,"code": 200,"message": "Request successful","data": {"items": [{"goods_id": "1731491957866860552","goods_name": "THE MONSTERS Let's Checkmate Series-Vinyl Plush Doll","goods_pic_url": "https://d3uucz7wx6jq40.cloudfront.net/tiktok.product/1731491957866860552/cover.png","currency_symbol": "$","goods_price": "114.99","goods_sales_revenue": "240559.08","goods_sales_volumn": 2092}],"total": 100,"page": 1,"page_size": 10,"total_pages": 10}}
使用场景
- 价格带匹配 — 了解红人常带货的价格区间是否与你的商品匹配。
- 竞品曝光排查 — 识别已经在推广竞品的红人。