cURL
curl --request GET \
--url 'https://api.keyapi.ai/v1/tiktok/video/ranking/analytics' \
--header 'Authorization: Bearer <YOUR_API_KEY>'import requests
response = requests.get(
'https://api.keyapi.ai/v1/tiktok/video/ranking/analytics',
params={},
headers={'Authorization': 'Bearer <YOUR_API_KEY>'}
)
print(response.json())const response = await fetch('https://api.keyapi.ai/v1/tiktok/video/ranking/analytics',
{
method: 'GET',
headers: { 'Authorization': 'Bearer <YOUR_API_KEY>' }
}
);
const data = await response.json();
console.log(data);HttpResponse<String> response = Unirest.get("https://api.keyapi.ai/v1/tiktok/video/ranking/analytics")
.header("Authorization", "Bearer <token>")
.asString();{
"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"
}{
"code": 400,
"data": null,
"message": "Missing required parameter: handle"
}{
"code": 401,
"data": null,
"message": "apiKey is null"
}{
"code": 402,
"data": null,
"message": "apiKey quota is not enough"
}{
"code": 429,
"data": null,
"message": "qps limit exceeded"
}{
"code": 500,
"data": null,
"message": "Internal server error"
}TikTok Content
Video Ranking -EchoTik
Retrieve ranked lists of TikTok videos by views, engagement, or sales metrics, computed from large-scale analytics data.
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>'import requests
response = requests.get(
'https://api.keyapi.ai/v1/tiktok/video/ranking/analytics',
params={},
headers={'Authorization': 'Bearer <YOUR_API_KEY>'}
)
print(response.json())const response = await fetch('https://api.keyapi.ai/v1/tiktok/video/ranking/analytics',
{
method: 'GET',
headers: { 'Authorization': 'Bearer <YOUR_API_KEY>' }
}
);
const data = await response.json();
console.log(data);HttpResponse<String> response = Unirest.get("https://api.keyapi.ai/v1/tiktok/video/ranking/analytics")
.header("Authorization", "Bearer <token>")
.asString();{
"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"
}{
"code": 400,
"data": null,
"message": "Missing required parameter: handle"
}{
"code": 401,
"data": null,
"message": "apiKey is null"
}{
"code": 402,
"data": null,
"message": "apiKey quota is not enough"
}{
"code": 429,
"data": null,
"message": "qps limit exceeded"
}{
"code": 500,
"data": null,
"message": "Internal server error"
}🪙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
Query Parameters
Specific time of the yyyy-MM-dd format ranking list
Region code, region, such as US
Filtering by the first-level category ID of products, used for filtering product categories in the live-streaming sales video rankings
true / false, whether it is an AI video
Ranking field 1=total_views_cnt 2=total_video_sale_cnt
Rank Type 1=day 2=week 3=month
Page numbers, starting from 1, maximum 100000
The maximum number of pages is 10.

