Pipispy API中文

Data usage rules: 1. Obtaining a data result consumes 1 data. Obtaining more detailed information about a data result does not consume data. 2. Ad Tracker: Each monitoring session costs $1/month. Each monitoring session is valid for one month and automatically expires after one month. Deleting a monitoring session does not restore the monitoring session, so please delete with caution. Monitoring sessions can be accessed at any time and are unlimited.

TikTok Product Detail API

API Information

  • API Name: Get TikTok Shop Product Detail
  • Request Method: POST
  • API URL: /open-api/v1/data
  • Interface URI path: /v3/api/open/tiktok-shop/product/detail
  • Description: Get detailed information of TikTok shop product by product ID
  • Pricing: Details API pricing rules: Base fee: 1 credit/request. Free access conditions (if either is met): Details for this ID have been retrieved within the past 3 days; This ID appeared in your leaderboard list query results within the past 3 days.

Request Headers:

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

Request Parameters

Request Structure

Parameter Name Type Description Example Required Default
key string User's external API request key "your_api_key_here" Yes
uri string Interface URI path "/v3/api/open/tiktok-shop/product/detail" Yes
params object Interface parameter object See parameter list below Yes

Parameter List (params object)

Parameter Name Type Description Example Required Default
id string Product unique identifier ID "123456789" Yes

Request Example

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"
    }
  }'

Response

Response Body Structure

{
  "code": 200,
  "message": "success",
  "data": {
    // Product detail information
  },
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 1,
  "success": true,
  "fail": false
}

Response Field Description

Main Response Fields
Field Name Type Description
data object Product detail information
version string API version
timestamp string/null Response timestamp
sign string/null Response signature
remaining_credits number Current remaining available credits after this request
consumed_credits number Credits consumed by this request
success boolean Request success status
fail boolean Request failure status
Product Detail Fields (data)
Field Name Type Description
id string Product unique identifier ID
image string Product main image URL
title string Product title
landing_page string Product landing page URL
desc string Product description
currency string Currency type
price double Product price (local currency)
price_usd double Product price in USD
sales_volume long Product sales volume
commission_rate double Commission rate
sales_trend integer Sales trend, 1-growth, 0-stable, -1-decline
sales_trend_data array Sales trend data list
score double Product rating
gmv double Sales volume (GMV)
gmv_usd double Sales volume in USD (GMV USD)
delivery string Delivery method, overseas-cross-border delivery, local-local delivery
is_in_marketplace boolean Whether it's a marketplace product
is_managed boolean Whether it's a fully managed product
person_count long Number of influencers
video_count long Number of ad videos
categorize object Product category information
region string Product target region
play_count long Play count/ad impressions
like_count long Like count
like_rate double Like rate
comment_count long Comment count
product_comment long Product comment count
share_count long Share count
found_time long First discovery time (timestamp)
last_found_time long Last discovery time (timestamp)
insert_time long Data insertion time (timestamp)
update_time long Data update time (timestamp)
min_cpm double Minimum ad cost (CPM)
max_cpm double Maximum ad cost (CPM)
shop_info object Shop information
is_collection boolean Whether it's collected
root_path string Product root path (domain)
image_list array Product image list URLs
Product Category Information Object Fields (categorize)
Field Name Type Description
_id string Category ID
parent_id string Parent category ID
name_zh string Category name in Chinese
name_vi string Category name in Vietnamese
name_th string Category name in Thai
name_pt string Category name in Portuguese
name_ja string Category name in Japanese
name_id string Category name in Indonesian
name_en string Category name in English
child_node object Child category information (nested structure)
Shop Information Object Fields (shop_info)
Field Name Type Description
image string Shop image URL
name string Shop name
avg_price double Average price (local currency)
currency string Currency type
id string Shop ID
goods_count long Number of goods
region array Shop target region list
avg_price_usd double Average price in USD
sales_volume long Shop sales volume
is_managed boolean Whether it's a fully managed shop
Sales Trend Data Object Fields (sales_trend_data)
Field Name Type Description
day long Date timestamp
sales_volume long Sales value for that day

Response Example

{
  "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
}

Error Codes

Error Code Description
200 Success
400 Bad Request - Request parameter error, such as missing product ID
404 Not Found - Product not found
500 Internal Server Error