TikTok 商品详情接口
API 信息
- API 名称: 获取 TikTok 小店商品详情
- 请求方法: POST
- API 地址:
/open-api/v1/data
- 接口路径:
/v3/api/open/tiktok-shop/product/detail
- 接口描述: 根据商品 ID 获取 TikTok 小店的商品详细信息
- 价格说明: 详情接口计费规则: 基础费用:1 credit/次。 免费访问条件(满足其一即可): 该ID在3天内已获取过详情;该ID在3天内出现在您的榜单列表查询结果中。
请求头:
- Content-Type: application/json
- Accept: application/json
请求参数
请求结构
| 参数名 |
类型 |
描述 |
示例 |
必填 |
默认值 |
| key |
string |
用户申请的外部 api 请求 key |
"your_api_key_here" |
是 |
|
| uri |
string |
接口路径 |
"/v3/api/open/tiktok-shop/product/detail" |
是 |
|
| params |
object |
接口入参对象 |
见参数列表 |
是 |
|
参数列表 (params 对象)
| 参数名 |
类型 |
必填 |
描述 |
示例 |
默认值 |
| id |
String |
是 |
商品唯一标识 ID |
"123456789" |
|
请求示例
curl -X POST "https://www.pipispy.com/open-api/v1/data" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"key": "your_api_key_here",
"uri": "/v3/api/open/tiktok-shop/product/detail",
"params": {
"id": "123456789"
}
}'
响应
响应体结构
{
"code": 200,
"message": "success",
"data": {
// 商品详情信息
},
"version": "v1",
"timestamp": null,
"sign": null,
"remaining_credits": 9980,
"consumed_credits": 1,
"success": true,
"fail": false
}
响应字段说明
主要响应字段
| 字段名 |
类型 |
描述 |
| data |
Object |
商品详情信息 |
| version |
String |
API 版本 |
| timestamp |
String/null |
响应时间戳 |
| sign |
String/null |
响应签名 |
| remaining_credits |
Long |
当前请求后的剩余可用积分 |
| consumed_credits |
Long |
本次请求消耗的积分 |
| success |
Boolean |
请求成功状态 |
| fail |
Boolean |
请求失败状态 |
商品详情字段 (data)
| 字段名 |
类型 |
描述 |
| id |
String |
商品唯一标识 ID |
| image |
String |
商品主图片 URL |
| title |
String |
商品标题 |
| landing_page |
String |
商品落地页 URL |
| desc |
String |
商品描述 |
| currency |
String |
货币类型 |
| price |
Double |
商品价格(本地货币) |
| price_usd |
Double |
商品美元价格 |
| sales_volume |
Long |
商品销量 |
| commission_rate |
Double |
佣金比例 |
| sales_trend |
Integer |
销售趋势,1-增长,0-平稳,-1-下降 |
| sales_trend_data |
Array |
销售趋势数据列表 |
| score |
Double |
商品评分 |
| gmv |
Double |
销售额(GMV) |
| gmv_usd |
Double |
美元销售额(GMV USD) |
| delivery |
String |
发货方式,overseas-跨境发货,local-本地发货 |
| is_in_marketplace |
Boolean |
是否联盟商品 |
| is_managed |
Boolean |
是否全托管商品 |
| person_count |
Long |
达人数量 |
| video_count |
Long |
广告视频数量 |
| categorize |
Object |
商品分类信息 |
| region |
String |
商品投放地区 |
| play_count |
Long |
播放量/广告曝光数 |
| like_count |
Long |
点赞数 |
| like_rate |
Double |
点赞率 |
| comment_count |
Long |
评论数 |
| product_comment |
Long |
商品评论数 |
| share_count |
Long |
分享数 |
| found_time |
Long |
首次发现时间(时间戳) |
| last_found_time |
Long |
最后发现时间(时间戳) |
| insert_time |
Long |
数据入库时间(时间戳) |
| update_time |
Long |
数据更新时间(时间戳) |
| min_cpm |
Double |
最小广告花费(CPM) |
| max_cpm |
Double |
最大广告花费(CPM) |
| shop_info |
Object |
店铺信息 |
| is_collection |
Boolean |
是否已收藏 |
| root_path |
String |
广告主(域名) |
| image_list |
Array |
商品图片列表 URL |
商品分类信息对象字段 (categorize)
| 字段名 |
类型 |
描述 |
| _id |
String |
分类 ID |
| parent_id |
String |
父分类 ID |
| name_zh |
String |
中文分类名称 |
| name_vi |
String |
越南语分类名称 |
| name_th |
String |
泰语分类名称 |
| name_pt |
String |
葡萄牙语分类名称 |
| name_ja |
String |
日语分类名称 |
| name_id |
String |
印尼语分类名称 |
| name_en |
String |
英语分类名称 |
| child_node |
Object |
子分类信息(嵌套结构) |
店铺信息对象字段 (shop_info)
| 字段名 |
类型 |
描述 |
| image |
String |
店铺图片 URL |
| name |
String |
店铺名称 |
| avg_price |
Double |
平均价格(本地货币) |
| currency |
String |
货币类型 |
| id |
String |
店铺 ID |
| goods_count |
Long |
商品数量 |
| region |
Array |
店铺投放地区列表 |
| avg_price_usd |
Double |
平均美元价格 |
| sales_volume |
Long |
店铺销量 |
| is_managed |
Boolean |
是否全托管店铺 |
销售趋势数据对象字段 (sales_trend_data)
| 字段名 |
类型 |
描述 |
| day |
Long |
日期时间戳 |
| sales_volume |
Long |
当日销售值 |
响应示例
{
"code": 200,
"message": "success",
"data": {
"id": "1729588788549551549",
"image": "https://cdn-product.pipispy.com/xd_7bc3ff56783ac45048d903b0d414c7fc.jpg",
"title": "[TANPA LEM] Dream Lashes L4 Sunflower Bulu Mata Palsu Tanpa Lem + FREE Tweezers",
"landing_page": "https://shop.tiktok.com/view/product/1729588788549551549?region=ID",
"desc": "✨ HALO DREAMERS! ✨\n\nSpecial untuk kalian : Beli 1 kotak bulu mata langsung mendapatkan bonus Twizzer...",
"currency": "IDR",
"price": 79900.0,
"price_usd": 4.91,
"sales_volume": 7606,
"commission_rate": 0.1,
"sales_trend": 1,
"sales_trend_data": [
{
"day": 1744214400,
"sales_volume": 9
},
{
"day": 1744300800,
"sales_volume": 10
}
],
"score": 4.7,
"gmv": 6.077194e8,
"gmv_usd": 37345.46,
"delivery": "local",
"is_in_marketplace": true,
"is_managed": true,
"person_count": 5,
"video_count": 17,
"categorize": {
"_id": "601450",
"parent_id": "0",
"name_zh": "美妆个护",
"name_vi": "Chăm sóc sắc đẹp & Chăm sóc cá nhân",
"name_th": "ความงามและของใช้ส่วนตัว",
"name_pt": "Beauty & Personal Care",
"name_ja": "Beauty & Personal Care",
"name_id": "Perawatan & Kecantikan",
"name_en": "Beauty & Personal Care",
"child_node": {
"_id": "848648",
"parent_id": "601450",
"name_zh": "美妆",
"name_vi": "Trang điểm",
"name_th": "เครื่องสำอาง",
"name_pt": "Makeup",
"name_ja": "Makeup",
"name_id": "Makeup",
"name_en": "Makeup",
"child_node": {
"_id": "824720",
"parent_id": "848648",
"name_zh": "假睫毛与胶水",
"name_vi": "Mí mắt giả & keo",
"name_th": "ขนตาปลอมและกาว",
"name_pt": "False Eyelashes & Adhesives",
"name_ja": "False Eyelashes & Adhesives",
"name_id": "Bulu Mata Palsu & Perekat",
"name_en": "False Eyelashes & Adhesives"
}
}
},
"region": "ID",
"play_count": 38217272,
"like_count": 207307,
"like_rate": 0.0054,
"comment_count": 1348,
"product_comment": 1013,
"share_count": 17907,
"found_time": 1718850206,
"last_found_time": 1752103443,
"insert_time": 1727694776,
"update_time": 1752115234,
"min_cpm": 15669.08,
"max_cpm": 63822.84,
"shop_info": {
"image": "https://cdn-product.pipispy.com/xd_cdca8fe4b5f6023d2f07.jpg",
"name": "Dream Lashes",
"avg_price": 75704.13,
"currency": "IDR",
"id": "7494784729622284733",
"goods_count": 16,
"region": ["ID"],
"avg_price_usd": 4.67,
"sales_volume": 183793,
"is_managed": true
},
"is_collection": false,
"root_path": "shop.tiktok.com",
"image_list": [
"https://cdn-product.pipispy.com/xd_7bc3ff56783ac45048d903b0d414c7fc.jpg",
"https://cdn-product.pipispy.com/xd_f6b642263b1c8483a639f246499cd24d.jpg",
"https://cdn-product.pipispy.com/xd_d706e48a17564cf167e8cc47fd2812a1.jpg"
]
},
"version": "v1",
"timestamp": null,
"sign": null,
"remaining_credits": 9980,
"consumed_credits": 1,
"success": true,
"fail": false
}
错误码
| 错误码 |
描述 |
| 200 |
成功 |
| 400 |
请求参数错误,如缺少商品 ID |
| 404 |
商品不存在 |
| 500 |
服务器内部错误 |