Sign in
TikTok

Top Search

Searches TikTok's 'Top' results by query — returns both videos and photo carousels, unlike keyword search which only returns videos. Returns items, an array of objects each with id, desc (caption), content_type (video or photo carousel), statistics (play_count, digg_count/likes, comment_count, share_count), video info, and images for carousels. Paginate with cursor. TikTok may return duplicate results.

get/v1/tiktok/search/top

Query parameters

querystring required

Keyword to search for

publish_time'yesterday' | 'this-week' | 'this-month' | 'last-3-months' | 'last-6-months' | 'all-time'

Time Frame TikTok was posted

sort_by'relevance' | 'most-liked' | 'date-posted'

Sort by

regionstring

Note, this doesn't filter the tiktoks only in a specfic region, it puts the proxy there. Use it in case you want to scrape posts only available for some country. Use 2 letter country codes like US, GB, FR, etc

cursornumber

Cursor to get more videos. Get 'cursor' from previous response.

Response

Successful response

Changes