Get Creator Profile

GET

/affiliate_creator/202508/profiles

Retrieves profile information for the creator associated with the access token. The creator must have a configured sales region; otherwise, the request fails with a precondition error.

Authorizations

• accessToken

Responses

200

Success

Media typeapplication/json

object

code

Status code; 0 means success.

integer format: int64

message

Success or failure message.

string

request_id

Request log ID.

string

data

object

avatar

Data associated with the TikTok creator’s profile avatar.

object

width

The avatar image width in pixels.

integer format: int64

height

The avatar image height in pixels.

integer format: int64

url

The URL for the TikTok creator’s avatar image file.

string

username

The TikTok user name.

string

selection_region

The region in which the creator is eligible to promote products in showcases, videos, and live streams.

string

register_region

The region in which the creator’s TikTok account is registered.

string

seller_type

If the creator is also also has a TikTok Shop seller account, the seller type of the creator. This is an enumerated type with values:

• CROSS_BORDER
• LOCAL

string

permissions

A list of product promotion permissions for the creator. The list can include zero or more of the following permissions:

• LIVE_STREAM_PERMISSION
• SELF_SALE_PERMISSION
• ADD_AFFILIATE_PERMISSION
• PHOTO_SHOPPABLE_PERMISSION_PRODUCT
• PHOTO_SHOPPABLE_PERMISSION_SHOP

Array<string>

user_type

The creator’s user type. This is an enumerated type with values:

• TIKTOK_SHOP_OFFICIAL_ACCOUNT
• TIKTOK_MARKETING_ACCOUNT
• TIKTOK_SHOP_CREATOR

string

creator_user_open_id

Creator Open ID. More details

string

Example

{
  "code": 0,
  "data": {
    "avatar": {
      "width": 100,
      "height": 100,
      "url": "https://p16-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/d76b8cc1b598de90ad5048df46e672b3~c5_100x100.webp?x-expires=1691895600&x-signature=oAT9KOL7aCN3Did9U%2FoKEsbBDj0%3D"
    },
    "username": "abc123",
    "selection_region": "US",
    "register_region": "US",
    "seller_type": "LOCAL",
    "permissions": [
      "LIVE_STREAM_PERMISSION",
      "SELF_SALE_PERMISSION",
      "ADD_AFFILIATE_PERMISSION"
    ],
    "user_type": "TIKTOK_SHOP_OFFICIAL_ACCOUNT",
    "creator_user_open_id": "uACafQAAAABmUU2qon4R0vUYvUVS3QC6CICP2m5A2-wd77j8R9G0yg"
  },
  "message": "Success",
  "request_id": "202203070749000101890810281E8C70B7"
}