SCscrapecreators
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. There is a 'Top' Search in TikTok and this is that. You can get Photo Carousels and Videos. Whereas with just the Keyword Search, you can only get Videos. Note: TikTok can return duplicate results for this search. Sorry about that — it looks like a TikTok-side thing, so we don't have control over it.

get/v1/tiktok/search/top

Request

  • Base URL
    https://api.scrapecreators.com
  • URL
    https://api.scrapecreators.com/v1/tiktok/search/top
  • Auth
    API key in header x-api-key

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

No recorded changes to this operation across all 24 revisions of this API.