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 Search - Realtime

Get Top Search - Realtime

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

API Overview This realtime top-search endpoint returns high-priority results from TikTok's search context for a keyword. It is useful when you want to understand what users are most likely to encounter at the top of search rather than what the recommendation feed is pushing.

Recommended Use Cases

  • Study keyword behavior in TikTok search
  • Understand search-surface competition around a term
  • Identify what content direction dominates top search results
  • Support SEO or search-oriented content planning

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

countstring10
Type
string
Required
No
Default
10
Example
10
offsetstringIf the value of the parameter has_more in the returned result is 1, a cursor value will be attached at the same time for retrieving the next batch of data0
Type
string
Required
No
Default
0
Example
0
If the value of the parameter has_more in the returned result is 1, a cursor value will be attached at the same time for retrieving the next batch of data
regionstringUS
Type
string
Required
Yes
Default
US
Example
US
keywordstringpretty
Type
string
Required
Yes
Default
pretty
Example
pretty
sort_typestringCan be empty or take the following values: 1 - Most Liked, 0 - Relevance First1
Type
string
Required
No
Default
1
Example
1
Can be empty or take the following values: 1 - Most Liked, 0 - Relevance First
publish_timestringFilter condition for release date, which can be empty or take one of the following values: 0 - All time, 1 - Yesterday, 7 - This week, 30 - This month, 90 - Past three months, 180 - Past six months0
Type
string
Required
No
Default
0
Example
0
Filter condition for release date, which can be empty or take one of the following values: 0 - All time, 1 - Yesterday, 7 - This week, 30 - This month, 90 - Past three months, 180 - Past six months

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-search?count=10&offset=0&region=US&keyword=pretty&sort_type=1&publish_time=0' \
  -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