跳转到主要内容
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"
}
🪙1 credit每次请求

​
Copy for AI

🤖 让 AI 帮你写调用代码

点击按钮复制一段结构化提示词，可直接交给 ChatGPT、Claude 或其他 AI 助手生成接口调用代码。

授权

​
Authorization
string
header
必填

接口鉴权凭证。请在请求 Header 中传入 Authorization: Bearer <YOUR_API_KEY>。 可在 Dashboard 获取你的 API Key。

查询参数

​
date
string
必填

榜单日期，格式为 yyyy-MM-dd。

​
region
string
必填

地区代码，例如 US。

​
product_category_id
string

商品一级类目 ID 筛选，用于直播带货视频榜单的商品类目过滤。

​
created_by_ai
string

是否为 AI 生成视频，取值 true 或 false。

​
video_rank_field
integer
必填

榜单排序字段，1=total_views_cnt，2=total_video_sale_cnt。

​
rank_type
integer
必填

榜单周期，1=日榜，2=周榜，3=月榜。

​
page_num
integer
必填

页码，从 1 开始，最大支持 100000。

​
page_size
integer
必填

每页返回数量，最大值为 10。

响应

请求成功

​
code
integer
必填
​
message
string
必填
​
data
object[]
必填
​
requestId
string
必填