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

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

No recorded changes to this endpoint across all 1 revision of this API.