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/Top AD search - Realtime

Top AD search - Realtime

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

API Overview This realtime top ads search endpoint searches popular TikTok ads by keyword. The response returns matching ad titles, brand names, budget level, CTR, likes, industry labels, campaign objectives, video covers, playback URLs, and pagination data, making it useful for finding ad creatives around product terms, brand names, categories, or selling points.

Recommended Use Cases

  • Research ads by keyword, product term, or brand term
  • Discover competitor, category, and selling-point related creatives
  • Expand an ad creative library with filters such as 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
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%
pagestring1
Type
string
Required
No
Default
1
Example
1
limitstring20
Type
string
Required
No
Default
20
Example
20
periodstringAvailable values: 7=Last 7 Days, 30=Last 30 Days, 180=Last 180 Days180
Type
string
Required
No
Default
30
Example
180
Available values: 7=Last 7 Days, 30=Last 30 Days, 180=Last 180 Days
keywordstringKurkurePakistan
Type
string
Required
Yes
Default
KurkurePakistan
Example
KurkurePakistan
industrystringIndustry ID,Select from the industry ID list. If omitted, no industry filter is applied and all industries are included.
Type
string
Required
No
Industry ID,Select from the industry ID list. If omitted, no industry filter is applied and all industries are included.
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 interactions like = Likes
Type
string
Required
No
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 like = Likes
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
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
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
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_codestring
Type
string
Required
No
Default
US

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-search?page=1&limit=20&period=180&keyword=KurkurePakistan' \
  -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