Skip to main content
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>'
{
  "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"
}
πŸͺ™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

Date, yyyy-MM-dd format

region
string
required

Country/region code (e.g. US, GB, DE)

category_id
string
category_l2_id
string
category_l3_id
string
seller_rank_field
integer
required

Ranking field 1=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