Skip to main content
GET
Top Search
💳 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

Example:

"funny"

publish_time
enum<string>

Time Frame TikTok was posted

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.

Response

Successful response

Key Response Fields:

  • data.items[].id: Video/post ID
  • data.items[].desc: Caption/description text (includes hashtags)
  • data.items[].content_type: Type of post — video or photo (carousel)
  • data.items[].create_time: ISO 8601 timestamp of when the post was published
  • data.items[].region: 2-letter country code where the post originated (e.g. US)
  • data.items[].url: Direct TikTok URL to the post
  • data.items[].statistics.play_count: Total views
  • data.items[].statistics.digg_count: Likes (TikTok calls likes "diggs")
  • data.items[].statistics.comment_count: Comments
  • data.items[].statistics.share_count: Shares
  • data.items[].statistics.collect_count: Bookmarks/saves
  • data.items[].statistics.download_count: Downloads
  • data.items[].video.cover.url_list[0]: Static thumbnail URL
  • data.items[].video.origin_cover.url_list[0]: Original cover image URL
  • data.items[].video.play_addr.url_list[0]: Video playback URL
  • data.items[].video.download_addr.url_list[0]: Video download URL
  • data.items[].video.duration: Video duration in milliseconds
  • data.items[].video.width / height: Video dimensions
  • data.items[].video.bit_rate[0].play_addr.url_list[0]: Highest quality video URL (multiple quality options available)
  • data.items[].author.unique_id: Author's TikTok username
  • data.items[].author.nickname: Author's display name
  • data.items[].author.uid: Author's numeric user ID
  • data.items[].author.sec_uid: Author's secure user ID (use for profile lookups)
  • data.items[].author.follower_count: Author's follower count
  • data.items[].author.avatar_larger.url_list[0]: Author's profile picture (high-res)
  • data.items[].is_ad: Whether the post is a paid advertisement
  • data.items[].is_paid_partnership: Whether it's a paid brand partnership
  • data.cursor: Pagination cursor — pass as cursor parameter to get the next page