Skip to main content
TikTok for DevelopersTikTok for Developers

Docs

Get User Profile Information

Overview

The user/info/ endpoint returns some basic information of a given TikTok user.

HTTP URL

https://open-api.tiktok.com/user/info/

HTTP Method

POST

Scope

  • user.info.basic

Request

Headers

Key

Type

Description

Example

Required

Content-Type

string

"application/json"

"application/json"

Yes

Body

Key

Type

Description

Example

Required

access_token


string

The token that bears the authorization of the TikTok user, which is obtained through /oauth/access_token/.

act.1d1021d2aee3d41fee2d2add43456badMFZnrhFhfWotu3Ecuiuka27L56lr

Yes

fields


set<string>

Choose fields from: UserObject's fields


["open_id", "avatar_url"]

Yes

Example

curl -L -X POST 'https://open-api.tiktok.com/user/info/' \
-H 'Content-Type: application/json' \
--data-raw '{
    "access_token": "act.1d1021d2aee3d41fee2d2add43456badMFZnrhFhfWotu3Ecuiuka27L56lr",
    "fields": ["open_id", "union_id", "avatar_url"]
}'

Response

Key

Type

Description

data

map<string, UserObject>

Contains user object

error

object

Contains error code and error message

UserObject

Field

Type

Description

Scope

open_id


string

The unique identification of the user in the current application.Open id for the client

user.info.basic

union_id


string


The unique identification of the user across different apps for the same developer. For example, if a partner has X number of clients, it will get X number of open_id for the same TikTok user, but one persistent union_id for the particular user


user.info.basic

avatar_url


string


User's profile image


user.info.basic

avatar_url_100


string

User`s profile image in 100x100 size

user.info.basic

avatar_large_url

string

User's profile image with higher resolution

user.info.basic


display_name


string

User's profile name

user.info.basic


bio_description


string

User's bio description if there is a valid one

user.info.basic

profile_deep_link

string

The link to user's TikTok profile page

user.info.basic

is_verified

boolean

Whether TikTok has provided a verified badge to the account after confirming that it belongs to the user it represents

user.info.basic


follower_count

int64

User's followers count

user.info.basic

following_count

int64

The number of accounts that the user is following

user.info.basic

likes_count

int64

The total number of likes received by the user across all of their videos

user.info.basic

email

string

User's verified email address

user.info.email

Example

{
    "data":{
        "user":{
            "avatar_url":"https://p-boei18n.bytedance.net/obj/aweme-upload-image/6919314666954933613",
            "open_id":"723f24d7-e717-40f8-a2b6-cb8463333b4",
            "union_id":"c9c60f44-a68e-4f5d-84dd-ce22fddb0ba1"
        }
    },
    "error":{
        "code":0,
        "message":""
    }
}