Skip to main content
GET
/
v1
/
tiktok
/
product
/
ranking
/
analytics
cURL
curl --request GET \
  --url 'https://api.keyapi.ai/v1/tiktok/product/ranking/analytics' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'
{
  "code": 0,
  "message": "success",
  "data": [
    {
      "category_id": "700645",
      "category_l2_id": "700646",
      "category_l3_id": "700650",
      "max_price": 26.77,
      "min_price": 21.59,
      "product_commission_rate": 0.15,
      "product_id": "1729413266549936259",
      "product_name": "Neuro Energy Caffeine Gum/Mints for Energy & Focus - Sugar-Free with L theanine, Caffeine, Vitamin B12 & Vitamin B6 - Peppermint Flavor",
      "region": "US",
      "spu_avg_price": 24.18,
      "total_ifl_cnt": 64,
      "total_live_cnt": 0,
      "total_sale_cnt": 4539,
      "total_sale_gmv_amt": 109753.02,
      "total_video_cnt": 95
    }
  ],
  "requestId": "af1eb642-cbb6-405a-b05b-84593afd41fc"
}
🪙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

​
date
string
required

List date, yyyy-MM-dd format

​
region
string
required

Region code, region, e.g. US

​
category_id
string
​
category_l2_id
string
​
category_l3_id
string
​
product_rank_field
integer
required

Ranking field1=total_sale_cnt 2=total_ifl_cnt

​
rank_type
integer
required

The ranking cycle is as follows: 1 = Daily Ranking, 2 = Weekly Ranking, 3 = Monthly Ranking.

​
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