cURL
curl --request GET \
--url 'https://api.keyapi.ai/v1/tiktok/shop/ranking/analytics' \
--header 'Authorization: Bearer <YOUR_API_KEY>'import requests
response = requests.get(
'https://api.keyapi.ai/v1/tiktok/shop/ranking/analytics',
params={},
headers={'Authorization': 'Bearer <YOUR_API_KEY>'}
)
print(response.json())const response = await fetch('https://api.keyapi.ai/v1/tiktok/shop/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/shop/ranking/analytics")
.header("Authorization", "Bearer <token>")
.asString();{
"code": 0,
"message": "success",
"data": [
{
"category_id": "601450",
"category_l2_id": "848776",
"category_l3_id": "601611",
"cover_url": "https://echosell-images.tos-ap-southeast-1.volces.com/seller-cover/222/7495514739648989419.png",
"most_product_category_list": "[{ \"category_name\":\"Beauty & Personal Care\",\"category_id\":\"601450\"}]",
"rating": 4.6,
"region": "US",
"seller_id": "7495514739648989419",
"seller_name": "medicube US Store",
"total_ifl_cnt": 31,
"total_live_cnt": 594,
"total_product_cnt": 0,
"total_sale_cnt": 19204,
"total_sale_gmv_amt": 603075.48,
"total_video_cnt": 94,
"user_id": "7291517492299007018"
}
],
"requestId": "54f91db1-5f45-43f1-b0b8-2b7421a0e2f7"
}{
"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 Shop
Shop Ranking -EchoTik
Retrieve ranked lists of TikTok Shop sellers by GMV, product count, or other metrics, computed from large-scale analytics data.
GET
/
v1
/
tiktok
/
shop
/
ranking
/
analytics
cURL
curl --request GET \
--url 'https://api.keyapi.ai/v1/tiktok/shop/ranking/analytics' \
--header 'Authorization: Bearer <YOUR_API_KEY>'import requests
response = requests.get(
'https://api.keyapi.ai/v1/tiktok/shop/ranking/analytics',
params={},
headers={'Authorization': 'Bearer <YOUR_API_KEY>'}
)
print(response.json())const response = await fetch('https://api.keyapi.ai/v1/tiktok/shop/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/shop/ranking/analytics")
.header("Authorization", "Bearer <token>")
.asString();{
"code": 0,
"message": "success",
"data": [
{
"category_id": "601450",
"category_l2_id": "848776",
"category_l3_id": "601611",
"cover_url": "https://echosell-images.tos-ap-southeast-1.volces.com/seller-cover/222/7495514739648989419.png",
"most_product_category_list": "[{ \"category_name\":\"Beauty & Personal Care\",\"category_id\":\"601450\"}]",
"rating": 4.6,
"region": "US",
"seller_id": "7495514739648989419",
"seller_name": "medicube US Store",
"total_ifl_cnt": 31,
"total_live_cnt": 594,
"total_product_cnt": 0,
"total_sale_cnt": 19204,
"total_sale_gmv_amt": 603075.48,
"total_video_cnt": 94,
"user_id": "7291517492299007018"
}
],
"requestId": "54f91db1-5f45-43f1-b0b8-2b7421a0e2f7"
}{
"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
Date, yyyy-MM-dd format
Country/region code (e.g. US, GB, DE)
Ranking field 1=total_sale_cnt 2=total_ifl_cnt
The ranking cycle is as follows: 1 = Daily Ranking, 2 = Weekly Ranking, 3 = Monthly Ranking.
Page numbers start from 1 and go up to a maximum of 100,000.
The maximum number of pages is 10.

