bodapi
首页API 产品联系我们
登录注册
bodapi

高质量数据 API 服务商

产品

  • API 产品

支持

  • 联系我们

账户

  • 登录
  • 注册
© 2026 bodapi. 保留所有权利。
概览
产品文档
版本
检索
目录
GETGet Influencer Follower List - Realtime1 额度/次GETGet Influencer Region - Realtime1 额度/次GETGet Influencer Following List - Realtime1 额度/次GETGet Influencer QR Code - Realtime1 额度/次GETGet Influencer Trends - Enriched1 额度/次GETGet Influencer Detail - Enriched1 额度/次GETGet Influencer Livestream List - Enriched1 额度/次GETGet Influencer Product List - Enriched1 额度/次GETGet Influencer Ranking List - Enriched1 额度/次GETGet Influencer Detail - Realtime1 额度/次GETGet Influencer Video List - Realtime1 额度/次GETGet Influencer List - Enriched1 额度/次GETGet Influencer Video List - Enriched1 额度/次
GETGet Shop Detail - Enriched1 额度/次GETGet Shop List - Enriched1 额度/次GETGet Shop Trends - Enriched1 额度/次GETGet Shop Product List - Enriched1 额度/次GETGet Shop Video List - Enriched1 额度/次GETGet Shop Livestream List - Enriched1 额度/次GETGet Shop Ranking List - Enriched1 额度/次GETGet Shop Influencer List - Enriched1 额度/次GETGet Shop Product List - Realtime1 额度/次
GETGet Product Detail Web - Realtime (unstable)1 额度/次GETGet Product Review List - Enriched1 额度/次GETSearch Products - Realtime1 额度/次GETGet Product Detail App - Realtime1 额度/次GETGet TikTok Shop Categories Level21 额度/次GETGet TikTok Shop Categories Level31 额度/次GETGet Product Review List - Realtime1 额度/次GETGet Product List - Enriched1 额度/次GETGet Product Detail - Enriched1 额度/次GETGet Product Influencer List - Enriched1 额度/次GETGet Product Ranking List - Enriched1 额度/次GETGet TikTok Shop Categories Level11 额度/次GETGet Product ID from Share Link - Realtime1 额度/次GETGet Product Trends - Enriched1 额度/次GETGet Product Video List - Enriched1 额度/次GETGet Product Livestream List - Enriched1 额度/次
GETInteractive time analysis - Realtime1 额度/次GETTop AD search - Realtime1 额度/次GETGet hashtag detail - Realtime1 额度/次GETGet the industry list - Realtime1 额度/次GETGet priority region - Realtime1 额度/次GETGet trend videos - Realtime1 额度/次GETGet hashtag list - Realtime1 额度/次GETGet top ads spotlight - Realtime1 额度/次GETGet top ads detail - Realtime1 额度/次GETGet top ads list - Realtime1 额度/次
GETGet Suggestions Users - Realtime1 额度/次GETGet Trending Search Term Ranking - Realtime1 额度/次GETGet Keyword Insight - Realtime1 额度/次
GETGet Music Ranking List - Realtime1 额度/次GETGet Music Video List - Realtime1 额度/次GETGet Music Detail - Realtime1 额度/次GETGet Sticker Video List - Realtime1 额度/次GETGet Sticker Detail - Realtime1 额度/次
GETGet Category Detail - Enriched1 额度/次GETGet Category Trends - Enriched1 额度/次
GETGet Video Comment Keywords - Realtime1 额度/次GETGet Video Interaction Trends - Realtime1 额度/次GETGet Influencer Milestones - Realtime1 额度/次
GETGet Top Search - Realtime1 额度/次GETSearch Product - Realtime1 额度/次GETSearch Hashtags - Realtime1 额度/次GETSearch Influencers - Realtime1 额度/次GETSearch Music - Realtime1 额度/次GETSearch Videos - Realtime1 额度/次GETSearch Live Streams - Realtime1 额度/次GETGeneral Search - Enriched1 额度/次GETImage Search Paged Product Data - Realtime1 额度/次POSTImage Search for Products - Realtime1 额度/次
GETBatch download cover images1 额度/次
GETGet Hashtag Video List - Realtime1 额度/次GETGet Video List - Enriched1 额度/次GETGet Video Ranking List - Enriched1 额度/次GETGet Recommended Video Stream - Realtime1 额度/次GETGet Trending Hashtag - Realtime1 额度/次GETGet Video Detail - Realtime1 额度/次GETGet Video Captions - Realtime1 额度/次GETGet Video Comment List - Realtime1 额度/次GETGet Video Comment Replies - Realtime1 额度/次GETGet Video Download URL - Realtime1 额度/次GETGet Video Detail - Enriched1 额度/次GETGet Video Product List - Enriched1 额度/次GETGet Video Trends - Enriched1 额度/次GETGet HashTag Trends - Enriched1 额度/次GETGet HashTag Ranking List - Enriched1 额度/次
GETGet Live List - Enriched1 额度/次GETGet Live Detail - Enriched1 额度/次GETGet Live Trends - Enriched1 额度/次GETGet Live Product List - Enriched1 额度/次GETGet Live Stream Detail - Realtime1 额度/次
API 产品/TikTok Ultra API/v1/Top AD search - Realtime

部分内容暂无中文,已显示英文

Top AD search - Realtime

GET/api/tiktok-ultra-api1/v1/api-v3-realtime-top-ads-search1 额度/次

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)

请求参数

按参数位置分区展示 gateway 校验规则。

Query 参数

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%
类型
string
必填
否
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
类型
string
必填
否
默认值
1
示例
1
limitstring20
类型
string
必填
否
默认值
20
示例
20
periodstringAvailable values: 7=Last 7 Days, 30=Last 30 Days, 180=Last 180 Days180
类型
string
必填
否
默认值
30
示例
180
Available values: 7=Last 7 Days, 30=Last 30 Days, 180=Last 180 Days
keywordstringKurkurePakistan
类型
string
必填
是
默认值
KurkurePakistan
示例
KurkurePakistan
industrystringIndustry ID,Select from the industry ID list. If omitted, no industry filter is applied and all industries are included.
类型
string
必填
否
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
类型
string
必填
否
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
类型
string
必填
否
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
类型
string
必填
否
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
类型
string
必填
否
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
类型
string
必填
否
默认值
US

Header 参数

X-Bodapi-Keystring在控制台的「API 密钥」页创建或查看密钥。
类型
string
必填
是
在控制台的「API 密钥」页创建或查看密钥。

请求示例

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"

在线调试

X-Bodapi-Key

请先登录后再使用在线调试。

点击「运行」查看实时响应结果