Skip to main content
GET
/
v1
/
tiktok
/
video
/
ranking
/
analytics
cURL
curl --request GET \
  --url 'https://api.keyapi.ai/v1/tiktok/video/ranking/analytics' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'
{
  "code": 0,
  "message": "success",
  "data": [
    {
      "avatar": "https://echosell-images.tos-ap-southeast-1.volces.com/user-avatar/853/MS4wLjABAAAAJN3v63JkTkZW72ae9hb2Wlb70uzhU8H3AZEKxIVTg38lwBGTx0tSNH7IBcrocdKd.jpg",
      "category": "Other",
      "create_time": "1769838405",
      "created_by_ai": "false",
      "duration": 15,
      "nick_name": "ﾌひﾚﾉの",
      "product_category_list": "[{ \"category_name\":\"Beauty & Personal Care\",\"category_id\":\"601450\"}]",
      "reflow_cover": "https://echosell-images.tos-ap-southeast-1.volces.com/video-cover/422/7601397977986501919.jpg",
      "region": "US",
      "sales_flag": 1,
      "total_comments_cnt": 0,
      "total_digg_cnt": 0,
      "total_favorites_cnt": 0,
      "total_shares_cnt": 0,
      "total_video_sale_cnt": 5508,
      "total_video_sale_gmv_amt": 44613,
      "total_views_cnt": 0,
      "unique_id": "iamjuliocr",
      "user_id": "6633792625097490438",
      "video_desc": "W huzz magnet 🧲 #fyp #ttshopfinds #seasaltspray #level3 #barbertok ",
      "video_id": "7601397977986501919",
      "video_products": "[1729436418527695003]"
    }
  ],
  "requestId": "b9ff3078-0b12-45b5-8b00-b7017ed18713"
}

Documentation Index

Fetch the complete documentation index at: https://docs.keyapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

🪙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

Specific time of the yyyy-MM-dd format ranking list

​
region
string
required

Region code, region, such as US

​
product_category_id
string

Filtering by the first-level category ID of products, used for filtering product categories in the live-streaming sales video rankings

​
created_by_ai
string

true / false, whether it is an AI video

​
video_rank_field
integer
required

Ranking field 1=total_views_cnt 2=total_video_sale_cnt

​
rank_type
integer
required

Rank Type 1=day 2=week 3=month

​
page_num
integer
required

Page numbers, starting from 1, maximum 100000

​
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