TikTok 店铺详情接口

API 信息

• API 名称: 获取 TikTok 小店店铺详情
• 请求方法: POST
• API 地址: /open-api/v1/data
• 接口路径: /v3/api/open/tiktok-shop/shop/detail
• 接口描述: 根据店铺 ID 获取 TikTok 小店的店铺详细信息
• 价格说明: 详情接口计费规则： 基础费用：1 credit/次。 免费访问条件（满足其一即可）： 该ID在3天内已获取过详情；该ID在3天内出现在您的榜单列表查询结果中。

请求头:

• Content-Type: application/json
• Accept: application/json

请求参数

请求结构

参数列表 (params 对象)

请求示例

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/shop/detail",
    "params": {
      "id": "shop_001"
    }
  }'

响应

响应体结构

{
  "code": 200,
  "message": "success",
  "data": {
    // 店铺详情信息
  },
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 1,
  "success": true,
  "fail": false
}

响应字段说明

主要响应字段

店铺详情字段 (data)

分类树形结构字段 (categorize)

最畅销商品对象字段 (best_selling_goods)

销售趋势数据对象字段 (sales_trend_data)

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "id": "shop_001",
    "shop_name": "时尚配件店",
    "shop_image": "https://example.com/shop.jpg",
    "is_managed": false,
    "is_in_marketplace": true,
    "landing_page": "https://example.com/shop",
    "desc": "专注于时尚手机配件的精品店铺，提供高品质的产品和服务",
    "region": ["US", "GB"],
    "region_str": "US, GB",
    "categorize": [
      {
        "_id": "cat_001",
        "name_zh": "手机配件",
        "name_en": "Phone Accessories",
        "child_node": null
      }
    ],
    "categorize_str": "Phone Accessories",
    "goods_count": 100,
    "goods_ad_count": 80,
    "goods_ad_rate": 0.8,
    "best_selling_goods": [
      {
        "product_id": "1730339920817197651",
        "image": "https://im.pipispy.com/products/images/5d1c88771fbae4a0.png",
        "sales_volume": 694
      },
      {
        "product_id": "1730348130623001171",
        "image": "https://im.pipispy.com/products/images/45c8040730ccac77.png",
        "sales_volume": 471
      }
    ],
    "sales_volume": 5000,
    "min_cpm": 2.0,
    "max_cpm": 8.0,
    "ad_cost": "USD 2.0-8.0",
    "avg_price": 35.0,
    "avg_price_usd": 35.0,
    "gmv": 150000.0,
    "gmv_usd": 150000.0,
    "sales_trend": 1,
    "sales_trend_str": "Growing",
    "sales_trend_data": [
      {
        "day": 1744300800,
        "sales_volume": 56
      },
      {
        "day": 1744387200,
        "sales_volume": 54
      }
    ],
    "score": 4.8,
    "video_count": 150,
    "play_count": 200000,
    "person_count": 120,
    "share_count": 5000,
    "found_time": 1640995200,
    "found_time_str": "01-01-2022",
    "last_found_time": 1643673600,
    "last_found_time_str": "01-02-2022",
    "insert_time": 1640995200,
    "update_time": 1643673600,
    "currency": "USD",
    "is_collection": false,
    "root_path": "example.com",
    "keywords": "时尚,配件,手机,精品",
    "commission_rate": 0.15,
    "product_type": ["brand"],
    "product_type_str": "brand",
    "delivery": ["local", "overseas"],
    "delivery_str": "local, overseas"
  },
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 1,
  "success": true,
  "fail": false
}

错误码