Skip to main content
GET
Profile Videos
💳 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

handle
string
required

TikTok handle

Example:

"stoolpresidente"

user_id
string

TikTok user id. Use this for faster responses.

Example:

"6659752019493208069"

sort_by
enum<string>

What to sort by (latest or popular)

Available options:
latest,
popular
Example:

"latest"

max_cursor
string

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

Example:

"1734562353000"

trim
boolean

Set to true for a trimmed down version of the response

Example:

false

Response

Successful response

Key Response Fields:

  • aweme_list[0].image_post_info.images: Slideshow images (you'll want all of the 'thumbnail' images
  • aweme_list[0].video.dynamic_cover.url_list: Thumbnail
  • aweme_list[0].statistics: All the counts for views, likes, comments, etc. will be in this key
  • aweme_list[0].statistics.play_count: Views
  • aweme_list[0].statistics.digg_count: Likes
  • aweme_list[0].aweme_id: Id of the tiktok. No idea why they call it this, but aweme is a name you'll find everywhere in tiktok responses.
  • aweme_list[0].video.play_addr.url_list: Video without watermark
  • aweme_list[0].is_ad: Whether the tiktok is an ad. Make sure you're looking at the is_ad field and not the is_ads field
  • aweme_list[0].is_top: is_top: 1 means the tiktok is pinned
  • aweme_list[0].is_eligible_for_commission: If video is promoting an item from tiktok shop