bodapi
HomeAPIsContact
LoginSign Up
bodapi

High-quality data API provider

Product

  • APIs

Support

  • Contact

Account

  • Login
  • Sign Up
© 2026 bodapi. All rights reserved.
Overview
Product
Version
Search
Endpoints
GETGet Influencer Follower List - Realtime1 credit/callGETGet Influencer Region - Realtime1 credit/callGETGet Influencer Following List - Realtime1 credit/callGETGet Influencer QR Code - Realtime1 credit/callGETGet Influencer Trends - Enriched1 credit/callGETGet Influencer Detail - Enriched1 credit/callGETGet Influencer Livestream List - Enriched1 credit/callGETGet Influencer Product List - Enriched1 credit/callGETGet Influencer Ranking List - Enriched1 credit/callGETGet Influencer Detail - Realtime1 credit/callGETGet Influencer Video List - Realtime1 credit/callGETGet Influencer List - Enriched1 credit/callGETGet Influencer Video List - Enriched1 credit/call
GETGet Shop Detail - Enriched1 credit/callGETGet Shop List - Enriched1 credit/callGETGet Shop Trends - Enriched1 credit/callGETGet Shop Product List - Enriched1 credit/callGETGet Shop Video List - Enriched1 credit/callGETGet Shop Livestream List - Enriched1 credit/callGETGet Shop Ranking List - Enriched1 credit/callGETGet Shop Influencer List - Enriched1 credit/callGETGet Shop Product List - Realtime1 credit/call
GETGet Product Detail Web - Realtime (unstable)1 credit/callGETGet Product Review List - Enriched1 credit/callGETSearch Products - Realtime1 credit/callGETGet Product Detail App - Realtime1 credit/callGETGet TikTok Shop Categories Level21 credit/callGETGet TikTok Shop Categories Level31 credit/callGETGet Product Review List - Realtime1 credit/callGETGet Product List - Enriched1 credit/callGETGet Product Detail - Enriched1 credit/callGETGet Product Influencer List - Enriched1 credit/callGETGet Product Ranking List - Enriched1 credit/callGETGet TikTok Shop Categories Level11 credit/callGETGet Product ID from Share Link - Realtime1 credit/callGETGet Product Trends - Enriched1 credit/callGETGet Product Video List - Enriched1 credit/callGETGet Product Livestream List - Enriched1 credit/call
GETInteractive time analysis - Realtime1 credit/callGETTop AD search - Realtime1 credit/callGETGet hashtag detail - Realtime1 credit/callGETGet the industry list - Realtime1 credit/callGETGet priority region - Realtime1 credit/callGETGet trend videos - Realtime1 credit/callGETGet hashtag list - Realtime1 credit/callGETGet top ads spotlight - Realtime1 credit/callGETGet top ads detail - Realtime1 credit/callGETGet top ads list - Realtime1 credit/call
GETGet Suggestions Users - Realtime1 credit/callGETGet Trending Search Term Ranking - Realtime1 credit/callGETGet Keyword Insight - Realtime1 credit/call
GETGet Music Ranking List - Realtime1 credit/callGETGet Music Video List - Realtime1 credit/callGETGet Music Detail - Realtime1 credit/callGETGet Sticker Video List - Realtime1 credit/callGETGet Sticker Detail - Realtime1 credit/call
GETGet Category Detail - Enriched1 credit/callGETGet Category Trends - Enriched1 credit/call
GETGet Video Comment Keywords - Realtime1 credit/callGETGet Video Interaction Trends - Realtime1 credit/callGETGet Influencer Milestones - Realtime1 credit/call
GETGet Top Search - Realtime1 credit/callGETSearch Product - Realtime1 credit/callGETSearch Hashtags - Realtime1 credit/callGETSearch Influencers - Realtime1 credit/callGETSearch Music - Realtime1 credit/callGETSearch Videos - Realtime1 credit/callGETSearch Live Streams - Realtime1 credit/callGETGeneral Search - Enriched1 credit/callGETImage Search Paged Product Data - Realtime1 credit/callPOSTImage Search for Products - Realtime1 credit/call
GETBatch download cover images1 credit/call
GETGet Hashtag Video List - Realtime1 credit/callGETGet Video List - Enriched1 credit/callGETGet Video Ranking List - Enriched1 credit/callGETGet Recommended Video Stream - Realtime1 credit/callGETGet Trending Hashtag - Realtime1 credit/callGETGet Video Detail - Realtime1 credit/callGETGet Video Captions - Realtime1 credit/callGETGet Video Comment List - Realtime1 credit/callGETGet Video Comment Replies - Realtime1 credit/callGETGet Video Download URL - Realtime1 credit/callGETGet Video Detail - Enriched1 credit/callGETGet Video Product List - Enriched1 credit/callGETGet Video Trends - Enriched1 credit/callGETGet HashTag Trends - Enriched1 credit/callGETGet HashTag Ranking List - Enriched1 credit/call
GETGet Live List - Enriched1 credit/callGETGet Live Detail - Enriched1 credit/callGETGet Live Trends - Enriched1 credit/callGETGet Live Product List - Enriched1 credit/callGETGet Live Stream Detail - Realtime1 credit/call
APIs/TikTok Ultra API/v1/Get Video Ranking List - Enriched

Get Video Ranking List - Enriched

GET/api/tiktok-ultra-api1/v1/api-v3-echotik-video-ranklist1 credit/call

API Overview This is EchoTik's offline video ranking endpoint. It returns ranked videos by date, region, category, AI status, and ranking metric, and combines creator context, content traits, engagement, views, estimated sales, and product linkage into each ranked record.

Recommended Use Cases

  • Track high-performing videos by market or category
  • Identify top commerce videos over a defined period
  • Compare AI-generated versus non-AI video performance
  • Build video leaderboard reporting

Notes

  • If returned cover, avatar, or image URLs cannot be accessed directly, you may need to use EchoTik's image download/conversion workflow
  • Data comes from EchoTik's offline database, so there can be a delay; if the API returns no data, it usually means the entity has not been collected by EchoTik yet

Request Parameters

Validation rules grouped by request section.

Query Parameters

datestringSpecific time of the yyyy-MM-dd format ranking list When the ranking type is selected as rank_type=1, the data can only store the most recent 30 days of data, so the selected date for \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"date\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\" cannot exceed the most recent 30 days; when the ranking type is selected as rank_type=2, the data can only store the most recent 12 weeks of data; when the ranking type is selected as rank_type=3, the data can only store the most recent 12 months of data.2025-11-01
Type
string
Required
Yes
Example
2025-11-01
Specific time of the yyyy-MM-dd format ranking list When the ranking type is selected as rank_type=1, the data can only store the most recent 30 days of data, so the selected date for \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"date\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\" cannot exceed the most recent 30 days; when the ranking type is selected as rank_type=2, the data can only store the most recent 12 weeks of data; when the ranking type is selected as rank_type=3, the data can only store the most recent 12 months of data.
regionstringRegion code, region, such as USUS
Type
string
Required
Yes
Example
US
Region code, region, such as US
page_numstringThe maximum number of pages is 10.1
Type
string
Required
Yes
Example
1
The maximum number of pages is 10.
page_sizestringThe maximum number of pages is 10.10
Type
string
Required
Yes
Example
10
The maximum number of pages is 10.
rank_typestringRank Type 1=day 2=week 3=month1
Type
string
Required
Yes
Example
1
Rank Type 1=day 2=week 3=month
aweme_typestringContent Type: 150 stands for image‑text posts.
Type
string
Required
No
Default
150
Content Type: 150 stands for image‑text posts.
created_by_aistringtrue / false, whether it is an AI video
Type
string
Required
No
true / false, whether it is an AI video
video_rank_fieldstringRanking field 1=total_views_cnt 2=total_video_sale_cnt1
Type
string
Required
Yes
Example
1
Ranking field 1=total_views_cnt 2=total_video_sale_cnt
product_category_idstringFiltering by the first-level category ID of products, used for filtering product categories in the live-streaming sales video rankings
Type
string
Required
No
Filtering by the first-level category ID of products, used for filtering product categories in the live-streaming sales video rankings
product_category_l2_idstringFiltering by the second-level category ID of products, used for filtering product categories in the live-streaming sales video rankings.
Type
string
Required
No
Filtering by the second-level category ID of products, used for filtering product categories in the live-streaming sales video rankings.
product_category_l3_idstringFiltering by the third-level category ID of products, used for filtering product categories in the live-streaming sales video rankings.
Type
string
Required
No
Filtering by the third-level category ID of products, used for filtering product categories in the live-streaming sales video rankings.

Header Parameters

X-Bodapi-KeystringCreate or view a key under API keys in the dashboard.
Type
string
Required
Yes
Create or view a key under API keys in the dashboard.

Request Examples

curl -X GET '/api/tiktok-ultra-api1/v1/api-v3-echotik-video-ranklist?date=2025-11-01&region=US&page_num=1&page_size=10&rank_type=1&video_rank_field=1' \
  -H "X-Bodapi-Key: $BODAPI_API_KEY"

Test This Endpoint

X-Bodapi-Key

Please sign in to use the live console.

Click "Run" to send a live request and see the response here