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 top ads list - Realtime

Get top ads list - Realtime

GET/api/tiktok-ultra-api1/v1/api-v3-realtime-top-ads-list1 credit/call

API Overview This realtime top ads list endpoint helps you explore high-performing auction ads on TikTok. The response returns ad titles, brand names, budget level, CTR, likes, industry labels, campaign objectives, video covers, multiple video playback URLs, and pagination data, making it useful as a live snapshot of ad creatives and paid media trends.

Recommended Use Cases

  • Monitor competitor ads and category creative trends
  • Find high-engagement or high-exposure ad materials
  • Build an ad creative library filtered by country, industry, objective, language, and format

Notes

  • Realtime endpoints may hit risk control; if the API returns code=500, keep retrying (code=500 does not consume your current usage quota)

Request Parameters

Validation rules grouped by request section.

Query Parameters

likestringLikes, If omitted, no like count percentile filter is applied and all ranges are included. Available values: 1=Top 1–20%, 2=Top 21–40%, 3=Top 41–60%, 4=Top 61–80%, 5=Top 81–100%
Type
string
Required
No
Default
1
Likes, If omitted, no like count percentile filter is applied and all ranges are included. Available values: 1=Top 1–20%, 2=Top 21–40%, 3=Top 41–60%, 4=Top 61–80%, 5=Top 81–100%
pagestringpage number1
Type
string
Required
No
Default
1
Example
1
page number
limitstringMaxPerPage20
Type
string
Required
No
Default
20
Example
20
MaxPerPage
periodstringAvailable values: 7=Last 7 Days, 30=Last 30 Days, 180=Last 180 Days30
Type
string
Required
No
Default
30
Example
30
Available values: 7=Last 7 Days, 30=Last 30 Days, 180=Last 180 Days
industrystringIndustry ID,Select from the industry ID list. If omitted, no industry filter is applied and all industries are included. For example: 27999000000
Type
string
Required
No
Default
27999000000,27103000000
Industry ID,Select from the industry ID list. If omitted, no industry filter is applied and all industries are included. For example: 27999000000
order_bystringSort by, Available values: for_you = See relevant Top Ads that are selected for you based on your activity and business information. impression = The total number of users who viewed the video at least once. ctr = Click-through rate (CTR) is a ratio that shows the amount of viewers that clicked the ad to the total amount of viewers. It is calculated by dividing the number of clicks by the number of viewers. play_2s_rate = The number of views that were 2 seconds or longer divided by the total number of video views. play_6s_rate = The number of views that were 6 seconds or longer divided by the total number of video views. cvr = Conversion rate (CVR) measure the percentage of conversions created (such as follows, downloads, or purchases) at every second in the video. It is calculated by dividing the number of conversions by the number of interactionsfor_you
Type
string
Required
No
Default
for_you
Example
for_you
Sort by, Available values: for_you = See relevant Top Ads that are selected for you based on your activity and business information. impression = The total number of users who viewed the video at least once. ctr = Click-through rate (CTR) is a ratio that shows the amount of viewers that clicked the ad to the total amount of viewers. It is calculated by dividing the number of clicks by the number of viewers. play_2s_rate = The number of views that were 2 seconds or longer divided by the total number of video views. play_6s_rate = The number of views that were 6 seconds or longer divided by the total number of video views. cvr = Conversion rate (CVR) measure the percentage of conversions created (such as follows, downloads, or purchases) at every second in the video. It is calculated by dividing the number of conversions by the number of interactions
ad_formatstringAd Format, If omitted, no ad format filter is applied and all formats are included. Available values: 1=Spark Ads, 2=Non-Spark Ads
Type
string
Required
No
Default
1
Ad Format, If omitted, no ad format filter is applied and all formats are included. Available values: 1=Spark Ads, 2=Non-Spark Ads
objectivestringObjective, If omitted, no campaign objective filter is applied and all objectives are included.Available values: 1=Traffic, 2=App Installs, 3=Conversions, 4=Video Views, 5=Reach, 8=Lead Generation, 15=Product Sales
Type
string
Required
No
Default
1
Objective, If omitted, no campaign objective filter is applied and all objectives are included.Available values: 1=Traffic, 2=App Installs, 3=Conversions, 4=Video Views, 5=Reach, 8=Lead Generation, 15=Product Sales
ad_languagestringAd Language, If omitted, no ad language filter is applied and all languages are included. Available values: en, es, ar, vi, th, de, id, pt, fr, ms, nl, ja, it, ro, zh-Hant, ko
Type
string
Required
No
Default
en
Ad Language, If omitted, no ad language filter is applied and all languages are included. Available values: en, es, ar, vi, th, de, id, pt, fr, ms, nl, ja, it, ro, zh-Hant, ko
country_codestringIf omitted, all countries are included. Available values can be obtained from /v1/tk-ads/get_priority_regionUS
Type
string
Required
No
Default
US
Example
US
If omitted, all countries are included. Available values can be obtained from /v1/tk-ads/get_priority_region

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-realtime-top-ads-list?page=1&limit=20&period=30&order_by=for_you&country_code=US' \
  -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