TikTok Insights Ads API
Retrieve insights on top-performing TikTok ads, including ad creative types, engagement rates, and industry distribution.
/v1/tiktok/insights/adssearch_keywordstringoptionalSearch keywords Value rule: FALSE (string type) = do not perform the search; non-empty string = perform the search according to the keyword
order_bystringoptionalType (choose one option) Recommendation = for_you Exposure = impression Click-through rate = ctr 2-second completion rate = play_2s_rate 6-second completion rate = play_6s_rate CVR = cvr Number of likes = like
pagestringoptionalPagination page number, used to specify the target page number of the query results
limitstringoptionalThe number of data items per page in pagination, which is used to specify the maximum number of results returned in a single query. The value range is 1 to 20. If it exceeds the maximum value, it will be automatically handled as 20.
periodstringoptionalTime range for querying data Optional valid values: 7 (last 7 days), 30 (last 30 days), 120 (last 120 days)
regionstringoptionalCountry/region code, example: US
industrystringoptionalIndustry ID, which can be found in the Hot Trends - Industry Classification Mapping
objectivestringoptionalDelivery Targets (Optional) Default value "nothing" means no delivery target is selected. Number of visits = 1 App installations = 2 Conversions = 3 Video views = 4 Reach = 5 Lead generation = 8 Product sales = 14
ad_languagestringoptionalAdvertising language (optional) The default value "nothing" means not selecting any advertising language. English = en Spanish = es Arabic = ar Vietnamese = vi Thai = th German = de Indonesian = id Portuguese = pt French = fr Malay = ms Dutch = n Japanese = ja Italian = it Romanian = ro Traditional Chinese = zh-Hant Korean = ko
ad_formatstringoptionalAd style (choose one option) The default value "nothing" means not selecting any condition. Spark Ads = 1 Non-Spark Ads = 2
likestringoptionalNumber of likes (optional) The default value "nothing" means no condition is selected. Top 1-20% = 1 Top 21-40% = 2 Top 41-60% = 3 Top 61-80% = 4 Top 81-100% = 5
TikTok API Use Cases
Trend Forecasting
Surface trending hashtags and sounds before they peak to get ahead of the curve.
Ad Intelligence
Analyze top-performing ad creatives to inform your own TikTok ad strategy.
Keyword Research
Understand search volume and trend data for keywords to optimize content discoverability.
Frequently Asked Questions
Is the TikTok API official?
No, KeyAPI provides an unofficial TikTok API that lets you access TikTok data through our platform. We handle the complexities of data collection so you can focus on building your application.
How current is the data?
We provide real-time data from TikTok. When you make a request, we fetch the latest information available.
How do credits work?
Each API endpoint consumes credits. Most endpoints cost just 1 credit. All pricing is transparent in our API documentation with no hidden fees.
Can I use this for AI model training?
Yes. KeyAPI provides structured, AI-ready data ideal for training datasets, fine-tuning LLMs, and building AI pipelines. Our historical archives are particularly valuable for large-scale training workloads.
Ready to unlock unified
social intelligence?
Register today and receive 100 free API calls to test our infrastructure.
Join the growing community of developers, AI builders, automation engineers, and global businesses who trust KeyAPI for reliable, scalable social media data access.