Skip to main content
GET
Search by Keyword
💳 1 credit per request

Authorizations

X-API-Key
string
header
required

API key for authentication. Format: sk_live_xxxxxxxxxxxxx

Get your API key from the Dashboard.

Query Parameters

query
string
required

Keyword to search for

date_posted
enum<string>

Time Frame

Available options:
yesterday,
this-week,
this-month,
last-3-months,
last-6-months,
all-time
Example:

"all-time"

sort_by
enum<string>

Sort by

Available options:
relevance,
most-liked,
date-posted
Example:

"relevance"

region
string

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

cursor
integer

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

Example:

10

trim
boolean

Set to true to get a trimmed response

Response

Successful response

Key Response Fields:

  • data.search_item_list[].aweme_info.aweme_id: Video ID
  • data.search_item_list[].aweme_info.desc: Caption/description text
  • data.search_item_list[].aweme_info.create_time: Unix timestamp of when the video was posted
  • data.search_item_list[].aweme_info.statistics.play_count: Total views
  • data.search_item_list[].aweme_info.statistics.digg_count: Likes
  • data.search_item_list[].aweme_info.statistics.comment_count: Comments
  • data.search_item_list[].aweme_info.statistics.share_count: Shares
  • data.search_item_list[].aweme_info.statistics.collect_count: Bookmarks/saves
  • data.search_item_list[].aweme_info.video.play_addr.url_list[0]: Video playback URL
  • data.search_item_list[].aweme_info.video.bit_rate[0].play_addr.url_list[0]: Highest quality video URL
  • data.search_item_list[].aweme_info.video.cover.url_list[0]: Thumbnail image URL
  • data.search_item_list[].aweme_info.video.duration: Video duration in milliseconds
  • data.search_item_list[].aweme_info.author.unique_id: Author's TikTok username
  • data.search_item_list[].aweme_info.author.nickname: Author's display name
  • data.search_item_list[].aweme_info.author.sec_uid: Author's secure user ID
  • data.search_item_list[].aweme_info.music.title: Sound/music title
  • data.search_item_list[].aweme_info.music.play_url.url_list[0]: Audio playback URL
  • data.cursor: Pagination cursor — pass as cursor parameter to get the next page
  • data.has_more: Whether more results are available (1 = yes)