TikTok user profile

Fetch a public TikTok profile by username, with its follower, like, and video totals.

GET /v1/tiktok/user/{username}

Path parameters

Parameter	Type	Description
username	string	Required. An @handle, a bare handle, or a profile URL.

Example

curl "$LISTENX_BASE/v1/tiktok/user/charlidamelio" \
  -H "X-API-Key: $LISTENX_KEY"

Response

{
  "username": "charlidamelio",
  "profile": {
    "id": "5831967",
    "unique_id": "charlidamelio",
    "nickname": "charli d'amelio",
    "sec_uid": "MS4wLjABAAAA…",
    "avatar_url": "https://…",
    "signature": "you can dance",
    "is_verified": true,
    "is_private": false,
    "region": "US",
    "follower_count": 155200000,
    "following_count": 1400,
    "heart_count": 11800000000,
    "video_count": 2600,
    "digg_count": 7100,
    "friend_count": 1200
  },
  "billing": {
    "endpoint": "tiktok.user",
    "units": 1,
    "unit_price": "0.010000",
    "amount": "0.010000",
    "balance_after": "97.000000",
    "request_id": "…"
  }
}

Fields

Field	Description
unique_id	The account's @handle.
follower_count	Followers.
heart_count	Total likes the account has received across all videos.
video_count	Number of public videos.
digg_count	Total likes the account has given.

Notes

• To list the account's videos, call GET /v1/tiktok/user/{username}/videos.

Billing

Charged per request (1 unit). See Billing.