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

hashtag
string
required

Hashtag to search for (without #)

region
string

Region the proxy will be set to. Note: this isn't going to grab you all tiktoks from this region, you're just setting the proxy there.

Example:

"US"

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.aweme_list[].aweme_id: Video ID
  • data.aweme_list[].desc: Caption/description text (includes hashtags)
  • data.aweme_list[].create_time: Unix timestamp of when the video was posted
  • data.aweme_list[].statistics.play_count: Total views
  • data.aweme_list[].statistics.digg_count: Likes
  • data.aweme_list[].statistics.comment_count: Comments
  • data.aweme_list[].statistics.share_count: Shares
  • data.aweme_list[].statistics.collect_count: Bookmarks/saves
  • data.aweme_list[].statistics.download_count: Downloads
  • data.aweme_list[].video.play_addr.url_list[0]: Video playback URL
  • data.aweme_list[].video.cover.url_list[0]: Thumbnail image URL
  • data.aweme_list[].video.duration: Video duration in milliseconds
  • data.aweme_list[].author.unique_id: Author's TikTok username
  • data.aweme_list[].author.nickname: Author's display name
  • data.aweme_list[].author.sec_uid: Author's secure user ID
  • data.aweme_list[].music.title: Sound/music title
  • data.aweme_list[].music.author: Sound/music artist
  • data.aweme_list[].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)