Skip to main content
GET
/
v1
/
tiktok
/
product
/
list
/
analytics
cURL
curl --request GET \
  --url 'https://api.keyapi.ai/v1/tiktok/product/list/analytics' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'
{
  "code": 0,
  "message": "success",
  "data": [
    {
      "category_id": "605248",
      "category_l2_id": "0",
      "category_l3_id": "0",
      "cover_url": "[{ \"url\":\"https://echosell-images.tos-ap-southeast-1.volces.com/product-cover/1004/1729873073559015752_3.webp\",\"index\":3},{ \"url\":\"https://echosell-images.tos-ap-southeast-1.volces.com/product-cover/1004/1729873073559015752_2.webp\",\"index\":2},{ \"url\":\"https://echosell-images.tos-ap-southeast-1.volces.com/product-cover/1004/1729873073559015752_1.webp\",\"index\":1},{ \"url\":\"https://echosell-images.tos-ap-southeast-1.volces.com/product-cover/1004/1729873073559015752_5.webp\",\"index\":5},{ \"url\":\"https://echosell-images.tos-ap-southeast-1.volces.com/product-cover/1004/1729873073559015752_7.webp\",\"index\":7},{ \"url\":\"https://echosell-images.tos-ap-southeast-1.volces.com/product-cover/1004/1729873073559015752_6.webp\",\"index\":6},{ \"url\":\"https://echosell-images.tos-ap-southeast-1.volces.com/product-cover/1004/1729873073559015752_4.webp\",\"index\":4},{ \"url\":\"https://echosell-images.tos-ap-southeast-1.volces.com/product-cover/1004/1729873073559015752_0.webp\",\"index\":0}]",
      "desc_detail": "[{\"type\":\"text\",\"text\":\"This Halloween Personality Cartoon Couple Pendant Stainless Steel Graffiti Stickman Keychain is a fun and unique accessory for expressing your personality.\"},{\"type\":\"ul\",\"content\":[\"Quirky Design\",\"Stainless Steel Material\",\"Perfect for Halloween\",\"Fashionable Baroque Style\"]},{\"type\":\"text\",\"text\":\"Add a touch of whimsy to your outfit with this foreign trade jewelry piece, featuring a graffiti stickman design that is sure to stand out.\"},{\"type\":\"image\",\"image\":{\"height\":800,\"width\":800,\"uri\":\"tos-useast5-i-omjb5zjo8w-tx/c06a01c04cf949e0a8c4a43f5ebfa582\",\"url_list\":[\"https://p19-oec-ttp.tiktokcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/c06a01c04cf949e0a8c4a43f5ebfa582~tplv-omjb5zjo8w-resize-webp:800:800.webp?from=1826719393\",\"https://p16-oec-ttp.tiktokcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/c06a01c04cf949e0a8c4a43f5ebfa582~tplv-omjb5zjo8w-resize-webp:800:800.webp?from=1826719393\"]}},{\"type\":\"image\",\"image\":{\"height\":800,\"width\":800,\"uri\":\"tos-useast5-i-omjb5zjo8w-tx/61767423e4554e00a8c92fa9bc0dd511\",\"url_list\":[\"https://p16-oec-ttp.tiktokcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/61767423e4554e00a8c92fa9bc0dd511~tplv-omjb5zjo8w-resize-webp:800:800.webp?dr=10507&nonce=65234&refresh_token=0ba56964a67c02158f849cfe6d39960c&from=1826719393&idc=useast8&ps=933b5bde&shcp=7745054a&shp=6ce186a1&t=555f072d\",\"https://p19-oec-ttp.tiktokcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/61767423e4554e00a8c92fa9bc0dd511~tplv-omjb5zjo8w-resize-webp:800:800.webp?dr=10507&nonce=64650&refresh_token=14a2f46d6e47593fd3cb93d29661e15f&from=1826719393&idc=useast8&ps=933b5bde&shcp=7745054a&shp=6ce186a1&t=555f072d\"]}},{\"type\":\"image\",\"image\":{\"height\":800,\"width\":800,\"uri\":\"tos-useast5-i-omjb5zjo8w-tx/9b078104e18f449b85752497e74227bf\",\"url_list\":[\"https://p16-oec-ttp.tiktokcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/9b078104e18f449b85752497e74227bf~tplv-omjb5zjo8w-resize-webp:800:800.webp?dr=10507&nonce=38574&refresh_token=bbd28101eb160fa73b2dfbdc2eda79fc&from=1826719393&idc=useast8&ps=933b5bde&shcp=7745054a&shp=6ce186a1&t=555f072d\",\"https://p19-oec-ttp.tiktokcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/9b078104e18f449b85752497e74227bf~tplv-omjb5zjo8w-resize-webp:800:800.webp?dr=10507&nonce=62503&refresh_token=0af3d34cfde2722893756a9914f0e42c&from=1826719393&idc=useast8&ps=933b5bde&shcp=7745054a&shp=6ce186a1&t=555f072d\"]}},{\"type\":\"image\",\"image\":{\"height\":800,\"width\":800,\"uri\":\"tos-useast5-i-omjb5zjo8w-tx/ff614cd67a794e539afafa72c562e7eb\",\"url_list\":[\"https://p16-oec-ttp.tiktokcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/ff614cd67a794e539afafa72c562e7eb~tplv-omjb5zjo8w-resize-webp:800:800.webp?dr=10507&nonce=12271&refresh_token=5d9cc218a6f97598aaec8ce441ab05ed&from=1826719393&idc=useast8&ps=933b5bde&shcp=7745054a&shp=6ce186a1&t=555f072d\",\"https://p19-oec-ttp.tiktokcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/ff614cd67a794e539afafa72c562e7eb~tplv-omjb5zjo8w-resize-webp:800:800.webp?dr=10507&nonce=65003&refresh_token=899764a731828682c6571ea86939a3c7&from=1826719393&idc=useast8&ps=933b5bde&shcp=7745054a&shp=6ce186a1&t=555f072d\"]}},{\"type\":\"image\",\"image\":{\"height\":532,\"width\":800,\"uri\":\"tos-useast5-i-omjb5zjo8w-tx/a1404d8d75cb4c82b5d716aec71f45ca\",\"url_list\":[\"https://p16-oec-ttp.tiktokcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/a1404d8d75cb4c82b5d716aec71f45ca~tplv-omjb5zjo8w-resize-webp:800:532.webp?from=1826719393\",\"https://p19-oec-ttp.tiktokcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/a1404d8d75cb4c82b5d716aec71f45ca~tplv-omjb5zjo8w-resize-webp:800:532.webp?from=1826719393\"]}},{\"type\":\"image\",\"image\":{\"height\":800,\"width\":800,\"uri\":\"tos-useast5-i-omjb5zjo8w-tx/76a38043110140e4b93d22472b3d90a7\",\"url_list\":[\"https://p16-oec-ttp.tiktokcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/76a38043110140e4b93d22472b3d90a7~tplv-omjb5zjo8w-resize-webp:800:800.webp?dr=10507&nonce=69811&refresh_token=ee4aa18d816d0154e460af223bbff97e&from=1826719393&idc=useast8&ps=933b5bde&shcp=7745054a&shp=6ce186a1&t=555f072d\",\"https://p19-oec-ttp.tiktokcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/76a38043110140e4b93d22472b3d90a7~tplv-omjb5zjo8w-resize-webp:800:800.webp?dr=10507&nonce=40309&refresh_token=df087bb470f0fe96c72bc22d201164ea&from=1826719393&idc=useast8&ps=933b5bde&shcp=7745054a&shp=6ce186a1&t=555f072d\"]}},{\"type\":\"image\",\"image\":{\"height\":800,\"width\":800,\"uri\":\"tos-useast5-i-omjb5zjo8w-tx/1f817a81a2734a89a6800b159e5ac951\",\"url_list\":[\"https://p19-oec-ttp.tiktokcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/1f817a81a2734a89a6800b159e5ac951~tplv-omjb5zjo8w-resize-webp:800:800.webp?from=1826719393\",\"https://p16-oec-ttp.tiktokcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/1f817a81a2734a89a6800b159e5ac951~tplv-omjb5zjo8w-resize-webp:800:800.webp?from=1826719393\"]}},{\"type\":\"image\",\"image\":{\"height\":800,\"width\":800,\"uri\":\"tos-useast5-i-omjb5zjo8w-tx/d49b25d67d5e406f88c4498b7ded6129\",\"url_list\":[\"https://p16-oec-ttp.tiktokcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/d49b25d67d5e406f88c4498b7ded6129~tplv-omjb5zjo8w-resize-webp:800:800.webp?dr=10507&nonce=32705&refresh_token=65c020c853d7f971eaa52e621940dc4e&from=1826719393&idc=useast8&ps=933b5bde&shcp=7745054a&shp=6ce186a1&t=555f072d\",\"https://p19-oec-ttp.tiktokcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/d49b25d67d5e406f88c4498b7ded6129~tplv-omjb5zjo8w-resize-webp:800:800.webp?dr=10507&nonce=39468&refresh_token=8d1081aa229ca5eeca1e484a8ff1833f&from=1826719393&idc=useast8&ps=933b5bde&shcp=7745054a&shp=6ce186a1&t=555f072d\"]}},{\"type\":\"image\",\"image\":{\"height\":800,\"width\":800,\"uri\":\"tos-useast5-i-omjb5zjo8w-tx/d4cc252f6f5f454895726db6cb3ec707\",\"url_list\":[\"https://p16-oec-ttp.tiktokcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/d4cc252f6f5f454895726db6cb3ec707~tplv-omjb5zjo8w-resize-webp:800:800.webp?dr=10507&nonce=8905&refresh_token=7d26c7d6ec404c58778945d33d48eaf6&from=1826719393&idc=useast8&ps=933b5bde&shcp=7745054a&shp=6ce186a1&t=555f072d\",\"https://p19-oec-ttp.tiktokcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/d4cc252f6f5f454895726db6cb3ec707~tplv-omjb5zjo8w-resize-webp:800:800.webp?dr=10507&nonce=74471&refresh_token=b3153581f22a34c0083804070404fbde&from=1826719393&idc=useast8&ps=933b5bde&shcp=7745054a&shp=6ce186a1&t=555f072d\"]}},{\"type\":\"text\",\"text\":\"Seller information\"},{\"type\":\"ul\",\"content\":[\"Business name: Putian Licheng District Fulin Electronic Commerce Co Ltd\",\"Business address (This address has been automatically translated for your convenience):Fujian, China\"]}]",
      "discount": "",
      "first_crawl_dt": 20241219,
      "free_shipping": 0,
      "is_s_shop": 0,
      "max_price": 1.99,
      "min_price": 1.99,
      "off_mark": 3,
      "product_commission_rate": 0,
      "product_id": "1729873073559015752",
      "product_name": "Halloween Personality Cartoon Couple Pendant Stainless Steel Graffiti Stickman Keychain Fun Personality Foreign Trade Jewelry.",
      "product_rating": 0,
      "region": "US",
      "review_count": 0,
      "sale_props": "[{\"prop_name\":\"Colour\",\"has_image\":\"true\",\"prop_id\":\"100000\",\"sale_prop_values\":[{\"image\":\"https://p16-oec-ttp.tiktokcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/691c7f20299846bc823fae485f93a116~tplv-omjb5zjo8w-crop-webp:800:800.webp?dr=10517&nonce=85056&refresh_token=c33c7c8f76c316b6b819f5992fd16627&from=1826719393&idc=useast8&ps=933b5bde&shcp=7745054a&shp=6ce186a1&t=555f072d\",\"prop_value_id\":\"6942409110390425345\",\"prop_value\":\"golden\"},{\"image\":\"https://p16-oec-ttp.tiktokcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/548da9f3c248435e8a44d25fa27ff58a~tplv-omjb5zjo8w-crop-webp:800:800.webp?from=1826719393\",\"prop_value_id\":\"6931958290813355778\",\"prop_value\":\"silver\"}]}]",
      "sales_flag": 0,
      "sales_trend_flag": 2,
      "seller_id": "7495981769829615944",
      "skus": "[{\"sku_id\":\"1729873073559081288\",\"sale_prop_value_ids\":\"6942409110390425345\",\"real_price\":{\"price_str\":\"$1.99\",\"price_val\":\"1.99\",\"currency\":\"USD\"}},{\"sku_id\":\"1729873073559146824\",\"sale_prop_value_ids\":\"6931958290813355778\",\"real_price\":{\"price_str\":\"$1.99\",\"price_val\":\"1.99\",\"currency\":\"USD\"}}]",
      "spu_avg_price": 1.99,
      "total_ifl_cnt": 0,
      "total_ifl_live_15d_cnt": 0,
      "total_ifl_live_1d_cnt": 0,
      "total_ifl_live_30d_cnt": 0,
      "total_ifl_live_60d_cnt": 0,
      "total_ifl_live_7d_cnt": 0,
      "total_ifl_live_90d_cnt": 0,
      "total_ifl_video_15d_cnt": 0,
      "total_ifl_video_1d_cnt": 0,
      "total_ifl_video_30d_cnt": 0,
      "total_ifl_video_60d_cnt": 0,
      "total_ifl_video_7d_cnt": 0,
      "total_ifl_video_90d_cnt": 0,
      "total_live_15d_cnt": 0,
      "total_live_1d_cnt": 0,
      "total_live_30d_cnt": 0,
      "total_live_60d_cnt": 0,
      "total_live_7d_cnt": 0,
      "total_live_90d_cnt": 0,
      "total_live_cnt": 0,
      "total_live_sale_15d_cnt": 0,
      "total_live_sale_1d_cnt": 0,
      "total_live_sale_30d_cnt": 0,
      "total_live_sale_60d_cnt": 0,
      "total_live_sale_7d_cnt": 0,
      "total_live_sale_90d_cnt": 0,
      "total_live_sale_cnt": 0,
      "total_live_sale_gmv_15d_amt": 0,
      "total_live_sale_gmv_1d_amt": 0,
      "total_live_sale_gmv_30d_amt": 0,
      "total_live_sale_gmv_60d_amt": 0,
      "total_live_sale_gmv_7d_amt": 0,
      "total_live_sale_gmv_90d_amt": 0,
      "total_live_sale_gmv_amt": 0,
      "total_sale_15d_cnt": 0,
      "total_sale_1d_cnt": 0,
      "total_sale_30d_cnt": 0,
      "total_sale_60d_cnt": 0,
      "total_sale_7d_cnt": 0,
      "total_sale_90d_cnt": 0,
      "total_sale_cnt": 0,
      "total_sale_gmv_15d_amt": 0,
      "total_sale_gmv_1d_amt": 0,
      "total_sale_gmv_30d_amt": 0,
      "total_sale_gmv_60d_amt": 0,
      "total_sale_gmv_7d_amt": 0,
      "total_sale_gmv_90d_amt": 0,
      "total_sale_gmv_amt": 0,
      "total_video_15d_cnt": 0,
      "total_video_1d_cnt": 0,
      "total_video_30d_cnt": 0,
      "total_video_60d_cnt": 0,
      "total_video_7d_cnt": 0,
      "total_video_90d_cnt": 0,
      "total_video_cnt": 0,
      "total_video_sale_15d_cnt": 0,
      "total_video_sale_1d_cnt": 0,
      "total_video_sale_30d_cnt": 0,
      "total_video_sale_60d_cnt": 0,
      "total_video_sale_7d_cnt": 0,
      "total_video_sale_90d_cnt": 0,
      "total_video_sale_cnt": 0,
      "total_video_sale_gmv_15d_amt": 0,
      "total_video_sale_gmv_1d_amt": 0,
      "total_video_sale_gmv_30d_amt": 0,
      "total_video_sale_gmv_60d_amt": 0,
      "total_video_sale_gmv_7d_amt": 0,
      "total_video_sale_gmv_90d_amt": 0,
      "total_video_sale_gmv_amt": 0,
      "total_views_15d_cnt": 0,
      "total_views_1d_cnt": 0,
      "total_views_30d_cnt": 0,
      "total_views_60d_cnt": 0,
      "total_views_7d_cnt": 0,
      "total_views_90d_cnt": 0,
      "total_views_cnt": 0
    }
  ],
  "requestId": "5c2f367b-72d7-4a86-9d9a-332b20b99c6d"
}
🪙1 creditper request

​
Copy for AI

🤖 Why Code When AI Can Do It For You?

Stop writing code like it’s 1970! Let AI do the heavy lifting - click the sparkles to copy a perfectly formatted prompt for ChatGPT, Claude, or your favorite AI assistant.

Authorizations

​
Authorization
string
header
required

API key for authentication. Format: sk_live_xxxxxxxxxxxxx Get your API key from the Dashboard.

Query Parameters

​
category_id
string

Product primary category ID

​
category_l2_id
string

Product secondary category ID

​
category_l3_id
string

Product subcategory ID

​
sales_trend_flag
integer

Sales trend in the past 7 days, 0=stable 1=up 2=down

​
min_total_sale_cnt
integer

Total sales range filter

​
max_total_sale_cnt
integer

Total sales range filter

​
min_total_sale_30d_cnt
integer

Sales range filter for the last 30 days

​
max_total_sale_30d_cnt
integer

Sales range filter for the last 30 days

​
min_spu_avg_price
number

Product SKU average price range filter

​
max_spu_avg_price
number

Product SKU average price range filter

​
min_product_commission_rate
number

Product commission rate range filtering

​
max_product_commission_rate
number

Product commission rate range filtering

​
min_total_ifl_cnt
integer

Filter by number of sales creators

​
max_total_ifl_cnt
integer

Filter by number of sales creators

​
min_total_video_cnt
integer

Sales video number range filter

​
max_total_video_cnt
integer

Sales video number range filter

​
min_total_views_cnt
integer

Filtering by the number of views for sales videos

​
max_total_views_cnt
integer

Filtering by the number of views for sales videos

​
min_product_rating
number

Product reviews are filtered by range

​
max_product_rating
number

Product reviews are filtered by range

​
min_review_count
integer

Product review count range filtering

​
max_review_count
integer

Product review count range filtering

​
is_s_shop
integer

Is it fully managed 0 = No, 1 = Fully managed

​
free_shipping
integer

Free shipping 0 = No 1 = Yes

​
min_total_sale_gmv_amt
number

Total GMV range filtering

​
max_total_sale_gmv_amt
number

Total GMV range filtering

​
min_total_sale_gmv_30d_amt
number

GMV range filtering in the last 30 days

​
max_total_sale_gmv_30d_amt
number

GMV range filtering in the last 30 days

​
min_first_crawl_dt
integer

Time range for the first capture of the product, format yyyyMMdd

​
max_first_crawl_dt
integer

Time range for the first capture of the product, format yyyyMMdd

​
sales_flag
integer

Main sales methods: 1. Video e-commerce; 2. Live streaming e-commerce

​
product_sort_field
integer

List sorting enumeration 1=total_sale_cnt 2=total_sale_gmv_amt 3=spu_avg_price 4=total_sale_7d_cnt 5=total_sale_30d_cnt 6=total_sale_gmv_7d_amt 7=total_sale_gmv_30d_amt

​
sort_type
integer

Sort order 0=asc 1=desc

​
region
string
required

Region code, region, such as US

​
page_num
integer
required

Page numbers start from 1 and go up to a maximum of 100,000.

​
page_size
integer
required

The maximum number of pages is 10.

Response

Success

​
code
integer
required
​
message
string
required
​
data
object[]
required
​
requestId
string
required