Pipispy APIEnglish

数据消耗规则:1. 获取一条数据结果消耗1 数据,获取数据结果的更多数据详情不消耗数据。2. 广告监控: 每次监控 $1 / 月。单个监控有效期为一个月,一个月后自动停止。删除监控不会恢复监控次数,请谨慎删除。监控调用为随时且无限次。

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 服务器内部错误