Skip to main content
GET
Following
💳 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"

min_time
integer

Used to paginate. Get 'min_time' from previous response.

Example:

1605663376

trim
boolean

Set to true to get a trimmed response

Response

Successful response

Key Response Fields:

  • data.followings[].unique_id: User's TikTok username
  • data.followings[].nickname: User's display name
  • data.followings[].uid: User's numeric ID
  • data.followings[].sec_uid: User's secure user ID (use for profile lookups)
  • data.followings[].signature: User's bio
  • data.followings[].follower_count: User's follower count
  • data.followings[].following_count: User's following count
  • data.followings[].total_favorited: Total likes received across all videos
  • data.followings[].aweme_count: Number of videos posted
  • data.followings[].favoriting_count: Number of videos the user has liked
  • data.followings[].avatar_larger.url_list[0]: Profile picture (high-res)
  • data.followings[].avatar_medium.url_list[0]: Profile picture (medium)
  • data.followings[].region: 2-letter country code
  • data.followings[].verification_type: Verification status (1 = verified)
  • data.followings[].create_time: Account creation Unix timestamp
  • data.total: Total number of accounts followed
  • data.has_more: Whether more results are available
  • data.min_time: Pagination cursor — pass as min_time parameter to get the next page