TikTok

Search TikTok videos by keyword

Search videos through TikTok's web video search (cursor and search_id paged, optional date and sort filters) as web item records. Each successful request costs 1 account credit, including partial results. Failed requests cost 0 credits.

get/v1/tiktok/search/keyword

Request

  • Base URL: https://api.scrapeatlas.com
  • URL: https://api.scrapeatlas.com/v1/tiktok/search/keyword
  • 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.