TikTok

Get TikTok top search results

Read TikTok's Top search tab (videos and photo carousels, cursor and search_id paged, optional date and sort filters) as the web app receives it: data rows with a type and the item record. Each successful request costs 1 account credit, including partial results. Failed requests cost 0 credits.

get/v1/tiktok/search/top

Request

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

Query parameters

querystring required

Search text, 1–100 characters.

cursorstring

Cursor (offset) from the previous response; send it with that response's search_id.

search_idstring

search_id from the first page's response; with cursor it continues the same search.

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

yesterday, this-week, this-month, last-3-months, last-6-months or all-time.

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

relevance, most-liked or date-posted.

regionstring

Two-letter region preference forwarded to TikTok.

number
OR
string

Earliest publication time to include, ISO 8601 or Unix seconds.

number
OR
string

Publication time to stop before, ISO 8601 or Unix seconds; later than since.

Response

Inspect the response status and failure or coverage fields.

OR

Changes

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