tiktok

Top Search

Access TikTok's 'Top' search results, which include both Photo Carousels and Videos. Unlike the Keyword Search endpoint, this returns mixed content types.

get/v1/scrape/tiktok/search/top

Request

  • Base URL: https://api.sociavault.com
  • URL: https://api.sociavault.com/v1/scrape/tiktok/search/top
  • Auth: API key in header X-API-Key

Query parameters

querystring required
Example:funny

Keyword to search for

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

Time Frame TikTok was posted

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

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

cursorinteger

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

Response

Successful response

Key Response Fields:

  • images: Slideshow images (you'll want all of the 'thumbnail' images

Changes

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