Can the TikTok API search videos, hashtags or trends?
Yes, the TikTok API can search videos, ads and trends, each in a separate API: the Research API searches public videos by keyword, hashtag, username, region or date, for researchers TikTok approves. The Commercial Content API searches ads by keyword or advertiser name. The API for Business returns popular hashtags, their trending videos and trending search keywords. The Display API reads an authorized user's own profile and videos.
easyCoexistence connects TikTok accounts through TikTok's API for Business, so Claude, ChatGPT or your own platform lists the account's posts and comments and reads its insights, and get_social_credentials gives your own code the token for business/ endpoints such as hashtag suggestions, with each connection watched around the clock.
Research API requests allowed per day, for up to 100,000 records, with the quota reset at 12 AM UTC.
Longest span between start_date and end_date in one Research API video query, which returns up to 100 videos a request.
Popular hashtags /discovery/trending_list/ ranks for a country and category over the last 1, 7, 30 or 120 days.
Trending search keywords /discovery/trending/search/ returns, for accounts with Advanced Access or a Verified Business Account.
Longest search_term the Commercial Content API takes, matched as an exact phrase by default or as a fuzzy phrase.
Which TikTok API can search?
Several, on two developer portals, each meant for a different kind of developer. developers.tiktok.com hosts the Research API, the Commercial Content API and the Display API; business-api.tiktok.com hosts the API for Business, whose Discovery, Accounts and Mentions endpoints cover trends and a business's own content:
How does the Research API search videos?
With POST https://open.tiktokapis.com/v2/research/video/query/ and a client access token holding the research.data.basic scope. The query object combines and, or and not conditions, each an operation such as EQ or IN on a field such as keyword, hashtag_name, username, region_code, create_date or video_length. start_date and end_date, written YYYYMMDD, can be at most 30 days apart, and max_count returns up to 100 videos a request:
curl -X POST 'https://open.tiktokapis.com/v2/research/video/query/?fields=id,video_description,create_time' \
-H 'Authorization: Bearer <CLIENT_ACCESS_TOKEN>' \
-H 'Content-Type: application/json' \
-d '{
"query": {
"and": [
{ "operation": "IN", "field_name": "region_code", "field_values": ["JP", "US"] },
{ "operation": "EQ", "field_name": "hashtag_name", "field_values": ["animal"] }
],
"not": [
{ "operation": "EQ", "field_name": "video_length", "field_values": ["SHORT"] }
]
},
"max_count": 100,
"start_date": "20261001",
"end_date": "20261030"
}'What does the Research API return, and how fresh is it?
The public video fields named in fields, such as id, video_description, create_time, region_code, view_count, like_count, comment_count, share_count, hashtag_names and username. TikTok's FAQ warns that statistics such as view and follower counts can take up to 10 days to update, and that new videos can take up to 48 hours to appear in search. The daily quota is 1,000 requests, up to 100,000 records across the research APIs, reset at 12 AM UTC.
Who can use the Research API?
Researchers whose project TikTok approves; a developer account alone does not grant access. TikTok lists academic institutions in the U.S., EEA, UK, Canada or Switzerland, not-for-profit or independent research bodies in the EU, and academic or not-for-profit organizations in Brazil studying online youth safety. Applicants work independently of commercial interests, with a defined research proposal, disclosed funding and an ethical review, and TikTok typically answers within 4 weeks. Asked whether creators, advertisers and commercial users are eligible, its FAQ answers no.
How do you search ads with the Commercial Content API?
With POST https://open.tiktokapis.com/v2/research/adlib/ad/query/ and the research.adlib.basic scope. search_term takes up to 50 characters, matched as exact_phrase by default or as fuzzy_phrase, which finds any or all of its words in any order; filters narrow the results by publishing dates and target countries, and each call returns at most 10 ads. TikTok's product page says the data starts with ads from the EU and stays available until a year after an ad was last shown. The public and researchers in any country can apply through an online form, and TikTok expects to answer within 2 working days.
Which trends does the API for Business return?
Those of its Discovery endpoints, which differ by the token they take. /discovery/trending_list/ ranks up to 200 popular hashtags for a country, US by default, and an industry category, over 1, 7, 30 or 120 days, with each hashtag's rank, views and posts, and /discovery/video_list/ returns the top 20 trending videos for up to 10 of those hashtags; both take an advertiser_id and an advertiser's access token. Two more take a TikTok account's token with the discovery.search.words scope, for accounts with Advanced Access or a Verified Business Account:
- /discovery/trending/search/: 20 search keywords trending on TikTok, or personalized for the account with
is_personalized. - /discovery/trending/search/keyword/: 20 recommended search keywords for a query of up to 255 characters, such as a product or brand.
What can a TikTok account's own API search?
Hashtags for its captions, and posts that carry its brand hashtags. GET /business/hashtag/suggestion/ takes a keyword and an optional language and returns 10 hashtags, ordered by exact match and then by number of posts, each with its post_count. The Mentions endpoint /business/mention/hashtag/video/list/ returns up to 1,000 public posts from the past 90 days that use one of the brand hashtags the business enabled, up to 50 of them, sorted by time, likes, comments or shares. It needs the biz.brand.insights scope and an account with Advanced Access or a Verified Business Account.
Can the Display API search?
No. It reads the user who authorized the app: /v2/user/info/ returns that user's profile, /v2/video/list/ their public videos, newest first and up to 20 a page, and /v2/video/query/ particular videos by ID, under the user.info.basic and video.list scopes. None of its endpoints takes a keyword or a hashtag.
What can easyCoexistence search on TikTok?
What the connected account's own API answers. list_social_posts lists the account's recent posts and list_social_comments a post's comments, while your own code calls API for Business paths under business/ with the token from get_social_credentials, hashtag suggestions included. /discovery/ paths take an advertiser's token, so the account's token does not reach them, and the Research and Commercial Content APIs are separate developers.tiktok.com products with applications of their own.
GET https://business-api.tiktok.com/open_api/v1.3/business/hashtag/suggestion/
?business_id=<BUSINESS_ID>&keyword=cold%20brew&language=en
Access-Token: <ACCESS_TOKEN>Common mistakes
- Applying for the Research API to track a brand. TikTok's FAQ answers no to creators, advertisers and commercial users, and approves non-commercial research projects.
- Querying a long period in one Research API call. end_date can be at most 30 days after start_date, so split longer periods into windows.
- Reading hashtag suggestions as trends. /business/hashtag/suggestion/ orders by exact match and post count, while /discovery/trending_list/ ranks popularity over a chosen period.
- Calling the trending search endpoints for a personal account. They answer for accounts with Advanced Access or a Verified Business Account, with discovery.search.words on the token.
US$ 9 to US$ 0.75 per connection per month, falling as you add connections, with the first 3 days free.
easyCoexistence is a multichannel API and MCP server that connects AI agents such as Claude and ChatGPT to WhatsApp, Instagram, TikTok, Facebook and more. On WhatsApp it uses Coexistence: the business keeps using its number in the WhatsApp Business app while the AI works through Meta's official API.
Frequently asked questions
Can I search TikTok videos by keyword through the API?
With the Research API, once TikTok approves your research project: its video query takes keyword and hashtag_name conditions over public videos, up to 100 per request.
Is there a TikTok API for trending hashtags?
Yes. /discovery/trending_list/ on the API for Business ranks up to 200 popular hashtags for a country and category, each with its views and posts, for an advertiser's token.
Is there a TikTok API for trending videos?
Yes. /discovery/video_list/ on the API for Business returns the top 20 trending videos for up to 10 popular hashtags, with an advertiser_id and an advertiser's access token.
Can the TikTok API find comments that mention my account?
Yes, for accounts with Advanced Access or a Verified Business Account: the Mentions API's /business/mention/comment/list/ returns up to 1,000 comments or replies that @mention the account, under the biz.brand.insights and comment.list scopes.
Keep reading
Connect your first channel in two minutes.
No platform reviews to wait for. Connect WhatsApp, Instagram, TikTok or another channel, then ask your AI to post, reply or report, and watch it work.
- 3 days free
- Cancel any time
- Official APIs only
- Monitored 24/7
Verified on