Douyin APIs - User Profile (V3)

prod-global

GET

/api/douyin/get-user-detail/v3

Retrieves detailed profile information of a Douyin user, including nickname, avatar, follower count, verification status, bio, and other user statistics.

Typical use cases:

Identifying creators and building creator lists
Enriching user records for analytics and reporting
Monitoring profile changes and audience growth

Parameters

Name	In	Type	Required	Description
`token`	query	`string`	Yes	Access token for this API service.
`secUid`	query	`string`	Yes	The unique user ID (sec_uid) on Douyin.

Code Samples

💡 Environment Note

Default samples use https://api.justoneapi.com (prod-global). For users in Mainland China, it is recommended to replace it with http://47.117.133.51:30015 (prod-cn) for better performance. See Environment Guide.

bash

# Tip: For Mainland China, replace https://api.justoneapi.com with http://47.117.133.51:30015
curl -X GET "https://api.justoneapi.com/api/douyin/get-user-detail/v3?token=YOUR_API_KEY&secUid=VALUE"

text

I want to use the "User Profile (V3)" API from Just One API.
API Endpoint: https://api.justoneapi.com/api/douyin/get-user-detail/v3
HTTP Method: GET
Authentication: Append "?token=YOUR_API_KEY" to the URL.
OpenAPI Definition: https://docs.justoneapi.com/openapi/douyin-apis/user-profile-v3-en.json

Parameters:
- token (query): Access token for this API service. (Required)
- secUid (query): The unique user ID (sec_uid) on Douyin. (Required)

Return format: JSON

Response Handling & Error Codes:
1. Business results should be determined by the "code" field in the response body (code 0 means success).
2. Timeout Recommendation: Set request timeout to at least 60 seconds.
3. Business Code Reference:
   - 0: Success
   - 100: Invalid or Inactive Token
   - 301: Collection Failed. Please Retry.
   - 302: Rate Limit Exceeded
   - 303: Daily Quota Exceeded
   - 400: Invalid Parameters
   - 500: Internal Server Error
   - 600: Permission Denied
   - 601: Insufficient Balance

Please help me write a script in my preferred programming language to call this API and handle the response.

python

# Tip: For Mainland China, replace https://api.justoneapi.com with http://47.117.133.51:30015
import requests

url = "https://api.justoneapi.com/api/douyin/get-user-detail/v3?token=YOUR_API_KEY&secUid=VALUE"
response = requests.get(url)
print(response.json())

// Tip: For Mainland China, replace https://api.justoneapi.com with http://47.117.133.51:30015
const response = await fetch("https://api.justoneapi.com/api/douyin/get-user-detail/v3?token=YOUR_API_KEY&secUid=VALUE", {
  method: "GET"
});
const data = await response.json();
console.log(data);

java

// Tip: For Mainland China, replace https://api.justoneapi.com with http://47.117.133.51:30015
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.justoneapi.com/api/douyin/get-user-detail/v3?token=YOUR_API_KEY&secUid=VALUE"))
            .method("GET", HttpRequest.BodyPublishers.noBody())
            .build();

        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

// Tip: For Mainland China, replace https://api.justoneapi.com with http://47.117.133.51:30015
package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	client := &http.Client{}
	url := "https://api.justoneapi.com/api/douyin/get-user-detail/v3?token=YOUR_API_KEY&secUid=VALUE"
	req, _ := http.NewRequest("GET", url, nil)
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

php

// Tip: For Mainland China, replace https://api.justoneapi.com with http://47.117.133.51:30015
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.justoneapi.com/api/douyin/get-user-detail/v3?token=YOUR_API_KEY&secUid=VALUE");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($ch);
curl_close($ch);
echo $response;

[OpenAPI Definition (JSON)]

Responses

json

{
  "code": 0,
  "data": {
    "extra": {
      "fatal_item_ids": null,
      "logid": "20260309223737D7B8B15960884E4C361B",
      "now": 1773067057000,
      "search_request_id": null
    },
    "log_pb": {
      "impr_id": "20260309223737D7B8B15960884E4C361B"
    },
    "status_code": 0,
    "status_msg": null,
    "user": {
      "account_cert_info": "{\"label_style\":5,\"label_text\":\"店铺授权号\",\"is_biz_account\":1}",
      "anchor_info": {
        "scheduled_master_switch": true,
        "scheduled_profile_switch": false,
        "scheduled_time_text": "10月14日 10:00"
      },
      "apple_account": 0,
      "avatar_168x168": {
        "height": 720,
        "uri": "aweme-avatar/tos-cn-avt-0015_f2099ca00a67d48fbc32fdac7ad63c62",
        "url_list": [
          "https://p3.douyinpic.com/aweme-avatar/tos-cn-avt-0015_f2099ca00a67d48fbc32fdac7ad63c62~tplv-dy-shrink:188:188.heic?from=2956013662",
          "https://p3.douyinpic.com/img/aweme-avatar/tos-cn-avt-0015_f2099ca00a67d48fbc32fdac7ad63c62~c5_168x168.heic?from=2956013662",
          "https://p11.douyinpic.com/img/aweme-avatar/tos-cn-avt-0015_f2099ca00a67d48fbc32fdac7ad63c62~c5_168x168.heic?from=2956013662",
          "https://p26.douyinpic.com/img/aweme-avatar/tos-cn-avt-0015_f2099ca00a67d48fbc32fdac7ad63c62~c5_168x168.heic?from=2956013662",
          "https://p3.douyinpic.com/img/aweme-avatar/tos-cn-avt-0015_f2099ca00a67d48fbc32fdac7ad63c62~c5_168x168.jpeg?from=2956013662"
        ],
        "width": 720
      },
      "avatar_300x300": {
        "height": 720,
        "uri": "aweme-avatar/tos-cn-avt-0015_f2099ca00a67d48fbc32fdac7ad63c62",
        "url_list": [
          "https://p3.douyinpic.com/aweme-avatar/tos-cn-avt-0015_f2099ca00a67d48fbc32fdac7ad63c62~tplv-dy-shrink:188:188.heic?from=2956013662",
          "https://p3.douyinpic.com/img/aweme-avatar/tos-cn-avt-0015_f2099ca00a67d48fbc32fdac7ad63c62~c5_300x300.heic?from=2956013662",
          "https://p11.douyinpic.com/img/aweme-avatar/tos-cn-avt-0015_f2099ca00a67d48fbc32fdac7ad63c62~c5_300x300.heic?from=2956013662",
          "https://p26.douyinpic.com/img/aweme-avatar/tos-cn-avt-0015_f2099ca00a67d48fbc32fdac7ad63c62~c5_300x300.heic?from=2956013662",
          "https://p3.douyinpic.com/img/aweme-avatar/tos-cn-avt-0015_f2099ca00a67d48fbc32fdac7ad63c62~c5_300x300.jpeg?from=2956013662"
        ],
        "width": 720
      },
      "avatar_is_digged": false,
      "avatar_larger": {
        "height": 720,
        "uri": "aweme-avatar/tos-cn-avt-0015_f2099ca00a67d48fbc32fdac7ad63c62",
        "url_list": [
          "https://p3.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-avt-0015_f2099ca00a67d48fbc32fdac7ad63c62.heic?from=2956013662",
          "https://p11.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-avt-0015_f2099ca00a67d48fbc32fdac7ad63c62.heic?from=2956013662",
          "https://p26.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-avt-0015_f2099ca00a67d48fbc32fdac7ad63c62.heic?from=2956013662",
          "https://p3.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-avt-0015_f2099ca00a67d48fbc32fdac7ad63c62.jpeg?from=2956013662"
        ],
        "width": 720
      },
      "avatar_medium": {
        "height": 720,
        "uri": "aweme-avatar/tos-cn-avt-0015_f2099ca00a67d48fbc32fdac7ad63c62",
        "url_list": [
          "https://p3.douyinpic.com/aweme-avatar/tos-cn-avt-0015_f2099ca00a67d48fbc32fdac7ad63c62~tplv-dy-shrink:188:188.heic?from=2956013662",
          "https://p3.douyinpic.com/aweme/720x720/aweme-avatar/tos-cn-avt-0015_f2099ca00a67d48fbc32fdac7ad63c62.heic?from=2956013662",
          "https://p11.douyinpic.com/aweme/720x720/aweme-avatar/tos-cn-avt-0015_f2099ca00a67d48fbc32fdac7ad63c62.heic?from=2956013662",
          "https://p26.douyinpic.com/aweme/720x720/aweme-avatar/tos-cn-avt-0015_f2099ca00a67d48fbc32fdac7ad63c62.heic?from=2956013662",
          "https://p3.douyinpic.com/aweme/720x720/aweme-avatar/tos-cn-avt-0015_f2099ca00a67d48fbc32fdac7ad63c62.jpeg?from=2956013662"
        ],
        "width": 720
      },
      "avatar_thumb": {
        "height": 720,
        "uri": "aweme-avatar/tos-cn-avt-0015_f2099ca00a67d48fbc32fdac7ad63c62",
        "url_list": [
          "https://p3.douyinpic.com/aweme-avatar/tos-cn-avt-0015_f2099ca00a67d48fbc32fdac7ad63c62~tplv-dy-shrink:188:188.heic?from=2956013662",
          "https://p3.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_f2099ca00a67d48fbc32fdac7ad63c62.heic?from=2956013662",
          "https://p11.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_f2099ca00a67d48fbc32fdac7ad63c62.heic?from=2956013662",
          "https://p26.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_f2099ca00a67d48fbc32fdac7ad63c62.heic?from=2956013662",
          "https://p3.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_f2099ca00a67d48fbc32fdac7ad63c62.jpeg?from=2956013662"
        ],
        "width": 720
      },
      "aweme_count": 643,
      "aweme_count_correction_threshold": -1,
      "birthday": "",
      "birthday_hide_level": 0,
      "can_set_item_cover": false,
      "can_show_group_card": 1,
      "card_entries": [
        {
          "card_data": "{\"is_order_card\":false,\"has_new\":false,\"is_store\":true,\"shop_id\":\"182358809\",\"product_count\":23,\"store_type\":\"shop\",\"icon_is_repeat\":false,\"icon_type\":\"png\",\"is_promotion_icon\":false,\"subtitle_resource_list\":\"\"}",
          "event_params": "{\"sub_title\":\"23件好物\",\"red_dot\":\"0\",\"function_status\":\"default\",\"entrance_location\":\"others_homepage_mid_numproduct\"}",
          "goto_url": "sslocal://goods/store?sec_shop_id=ULLPxUeS&entrance_location=others_homepage_mid_numproduct&tab_id=3&url_maker=shop_sdk&pass_through_api=%7B%22feed_entry_type%22%3A%2214%22%2C%22pre_sec_author_id%22%3A%22MS4wLjABAAAAV0pW9WMKqO7LgvttqNA92O3Fsppnnwkh6vvs9Z9zPhMkQ6GPEi-at60BulpmZYnm%22%7D",
          "icon_dark": {
            "url_list": [
              "https://lf3-static.bytednsdoc.com/obj/eden-cn/wvoz_j_tvjl/ljhwZthlaukjlkulzlp/new_shop_out_icon/[email protected]"
            ]
          },
          "icon_light": {
            "url_list": [
              "https://lf3-static.bytednsdoc.com/obj/eden-cn/wvoz_j_tvjl/ljhwZthlaukjlkulzlp/new_shop_out_icon/[email protected]"
            ]
          },
          "sub_title": "23件好物",
          "title": "进入店铺",
          "type": 1
        }
      ],
      "city": "",
      "close_friend_type": 0,
      "commerce_info": {
        "challenge_list": [],
        "head_image_list": null,
        "offline_info_list": null,
        "smart_phone_list": null,
        "task_list": null
      },
      "commerce_permissions": {
        "enterprise": 1,
        "head_image": 1
      },
      "commerce_user_info": {
        "ad_revenue_rits": null,
        "has_ads_entry": true,
        "show_star_atlas_cooperation": false,
        "star_atlas": 1
      },
      "commerce_user_level": 1,
      "country": "",
      "cover_and_head_image_info": {
        "cover_list": null,
        "profile_cover_list": [
          {
            "cover_url": {
              "uri": "douyin-user-image-file/f7ca8cd4b55fe59ac7e6d74ce0045c10",
              "url_list": [
                "https://p3-sign.douyinpic.com/douyin-user-image-file/f7ca8cd4b55fe59ac7e6d74ce0045c10~tplv-dy-resize-walign-adapt-aq-pf:750:q82.heic?lk3s=93de098e&x-expires=1773237600&x-signature=li6Ryo6XDXiO1z6rdcWeXUJvkHI%3D&from=2480802190&s=profile&se=false&sc=cover&l=20260309223737D7B8B15960884E4C361B",
                "https://p26-sign.douyinpic.com/douyin-user-image-file/f7ca8cd4b55fe59ac7e6d74ce0045c10~tplv-dy-resize-walign-adapt-aq-pf:750:q82.heic?lk3s=93de098e&x-expires=1773237600&x-signature=BY75ajgMd6t0KVU4mAktv1b2MaU%3D&from=2480802190&s=profile&se=false&sc=cover&l=20260309223737D7B8B15960884E4C361B",
                "https://p9-sign.douyinpic.com/douyin-user-image-file/f7ca8cd4b55fe59ac7e6d74ce0045c10~tplv-dy-resize-walign-adapt-aq-pf:750:q82.heic?lk3s=93de098e&x-expires=1773237600&x-signature=zV6tdZJ9sODIhn3C2X20ntFw9FU%3D&from=2480802190&s=profile&se=false&sc=cover&l=20260309223737D7B8B15960884E4C361B",
                "https://p3-sign.douyinpic.com/douyin-user-image-file/f7ca8cd4b55fe59ac7e6d74ce0045c10~tplv-dy-resize-walign-adapt-aq-pf:750:q82.jpeg?lk3s=93de098e&x-expires=1773237600&x-signature=po1wiYpdzCSvSkS%2FqO4YEy5oqsA%3D&from=2480802190&s=profile&se=false&sc=cover&l=20260309223737D7B8B15960884E4C361B"
              ]
            },
            "dark_cover_color": "#FF524e46",
            "light_cover_color": "#FF524e46"
          }
        ]
      },
      "cover_colour": "#03997706",
      "cover_url": [
        {
          "uri": "douyin-user-image-file/f7ca8cd4b55fe59ac7e6d74ce0045c10",
          "url_list": [
            "https://p3-sign.douyinpic.com/douyin-user-image-file/f7ca8cd4b55fe59ac7e6d74ce0045c10~tplv-dy-resize-walign-adapt-aq-pf:750:q82.heic?lk3s=93de098e&x-expires=1773237600&x-signature=li6Ryo6XDXiO1z6rdcWeXUJvkHI%3D&from=2480802190&s=profile&se=false&sc=cover&l=20260309223737D7B8B15960884E4C361B",
            "https://p26-sign.douyinpic.com/douyin-user-image-file/f7ca8cd4b55fe59ac7e6d74ce0045c10~tplv-dy-resize-walign-adapt-aq-pf:750:q82.heic?lk3s=93de098e&x-expires=1773237600&x-signature=BY75ajgMd6t0KVU4mAktv1b2MaU%3D&from=2480802190&s=profile&se=false&sc=cover&l=20260309223737D7B8B15960884E4C361B",
            "https://p9-sign.douyinpic.com/douyin-user-image-file/f7ca8cd4b55fe59ac7e6d74ce0045c10~tplv-dy-resize-walign-adapt-aq-pf:750:q82.heic?lk3s=93de098e&x-expires=1773237600&x-signature=zV6tdZJ9sODIhn3C2X20ntFw9FU%3D&from=2480802190&s=profile&se=false&sc=cover&l=20260309223737D7B8B15960884E4C361B",
            "https://p3-sign.douyinpic.com/douyin-user-image-file/f7ca8cd4b55fe59ac7e6d74ce0045c10~tplv-dy-resize-walign-adapt-aq-pf:750:q82.jpeg?lk3s=93de098e&x-expires=1773237600&x-signature=po1wiYpdzCSvSkS%2FqO4YEy5oqsA%3D&from=2480802190&s=profile&se=false&sc=cover&l=20260309223737D7B8B15960884E4C361B"
          ]
        },
        {
          "uri": "c8510002be9a3a61aad2",
          "url_list": [
            "https://p11-sign.douyinpic.com/c8510002be9a3a61aad2~tplv-dy-resize-walign-adapt-aq-pf:750:q82.heic?lk3s=93de098e&x-expires=1773237600&x-signature=n9iVNskloKWg2NzIKsh9%2BpqqBS8%3D&from=2480802190&s=profile&se=false&sc=cover&l=20260309223737D7B8B15960884E4C361B",
            "https://p3-sign.douyinpic.com/c8510002be9a3a61aad2~tplv-dy-resize-walign-adapt-aq-pf:750:q82.heic?lk3s=93de098e&x-expires=1773237600&x-signature=v8eoU4rKzd4ZSRhLa35N46S9%2BX8%3D&from=2480802190&s=profile&se=false&sc=cover&l=20260309223737D7B8B15960884E4C361B",
            "https://p26-sign.douyinpic.com/c8510002be9a3a61aad2~tplv-dy-resize-walign-adapt-aq-pf:750:q82.heic?lk3s=93de098e&x-expires=1773237600&x-signature=rcLfXFpmk1rFGNbmiiLm0AnPzbo%3D&from=2480802190&s=profile&se=false&sc=cover&l=20260309223737D7B8B15960884E4C361B",
            "https://p11-sign.douyinpic.com/c8510002be9a3a61aad2~tplv-dy-resize-walign-adapt-aq-pf:750:q82.jpeg?lk3s=93de098e&x-expires=1773237600&x-signature=BBQj%2F8%2FMIM0W708%2FzNjNKb%2BEmOs%3D&from=2480802190&s=profile&se=false&sc=cover&l=20260309223737D7B8B15960884E4C361B"
          ]
        }
      ],
      "custom_verify": "",
      "district": "",
      "dongtai_count": 0,
      "dynamic_cover": {},
      "elfemoji_status": -1,
      "enable_ai_double": 0,
      "enable_wish": false,
      "endorsement_info_list": [
        {
          "action": "aweme://webview/?url=https%3A%2F%2Ffe.amemv.com%2Ffalcon%2Faccount_react%2Fpages%2Fcert_show%2Findex.html%3Fhide_nav_bar%3D1%26enter_from%3Dhomepage_tag%26short_id%3D24860150964",
          "dark_icon_url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/oqj/ic_s_s_medel_outlined_16_dark_3x.png",
          "endorsement_type": 2,
          "light_icon_url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/oqj/ic_s_s_medel_outlined_16_light_3x.png",
          "line_break_type": 1,
          "link_type": "business_certificate",
          "text": "欧态官方旗舰店授权资质"
        }
      ],
      "enterprise_user_info": "{\"commerce_info\":{\"offline_info_list\":[],\"challenge_list\":[],\"task_list\":null,\"head_image_list\":null,\"smart_phone_list\":null},\"homepage_bottom_toast\":null,\"tab_settings\":{\"enterprise_tab\":{\"title\":\"商家\",\"tab_type\":0,\"show_tab_settings\":true,\"tab_link\":\"aweme://lynxview/?enter_from=profile\\u0026hide_nav_bar=1\\u0026dynamic=1\\u0026is_editor=0\\u0026is_checking=0\\u0026loading_bgcolor=00000000\\u0026needReloadWithTheme=1\\u0026use_bdx=1\\u0026trans_status_bar=1\\u0026use_gecko_first=1\\u0026container_bgcolor=00000000\\u0026enable_font_scale=1\\u0026channel=mp_lynx_tab\\u0026page_enabled=1\\u0026page_priority=1\\u0026template_id=0\\u0026record_id=0\\u0026is_owner=0\\u0026sec_to_user_id=MS4wLjABAAAAV0pW9WMKqO7LgvttqNA92O3Fsppnnwkh6vvs9Z9zPhMkQ6GPEi-at60BulpmZYnm\\u0026to_user_id=2483133812581103\\u0026business_type=0\\u0026offline_info_count=0\\u0026surl=https%3A%2F%2Flf-dy-sourcecdn-tos.bytegecko.com%2Fobj%2Fbyte-gurd-source%2Faweme%2Fplatform%2Flynx%2Fmp_lynx_tab%2Ftemplate.js\\u0026bundle=template.js\",\"show_tab_style\":0}},\"permissions\":[{\"Id\":3,\"Key\":\"ItemShop\",\"Name\":\"视频电商\",\"AppId\":1128,\"Status\":1,\"Parent\":0,\"CreateTime\":1773067057,\"UpdateTime\":1773067057},{\"Id\":4,\"Key\":\"LiveShop\",\"Name\":\"直播电商\",\"AppId\":1128,\"Status\":1,\"Parent\":0,\"CreateTime\":1773067057,\"UpdateTime\":1773067057},{\"Id\":5,\"Key\":\"UserShop\",\"Name\":\"个人橱窗\",\"AppId\":1128,\"Status\":1,\"Parent\":1,\"CreateTime\":1773067057,\"UpdateTime\":1773067057},{\"Id\":37,\"Key\":\"HeadImage\",\"Name\":\"商家头图\",\"AppId\":1128,\"Status\":1,\"Parent\":0,\"CreateTime\":1773067057,\"UpdateTime\":1773067057},{\"Id\":76,\"Key\":\"EHomepageTabManagement\",\"Name\":\"商家页面\",\"AppId\":1575,\"Status\":1,\"Parent\":17,\"CreateTime\":1773067057,\"UpdateTime\":1773067057},{\"Id\":81,\"Key\":\"Enterprise\",\"Name\":\"企业权限标识\",\"AppId\":1128,\"Status\":1,\"Parent\":0,\"CreateTime\":1773067057,\"UpdateTime\":1773067057},{\"Id\":120,\"Key\":\"IMMonitor\",\"Name\":\"私信监管\",\"AppId\":1128,\"Status\":1,\"Parent\":0,\"CreateTime\":1773067057,\"UpdateTime\":1773067057},{\"Id\":443,\"Key\":\"EIMCommand\",\"Name\":\"私信指令消息\",\"AppId\":1128,\"Status\":1,\"Parent\":12,\"CreateTime\":1773067057,\"UpdateTime\":1773067057}],\"e_role_key\":\"EAccountS\",\"tab_ceiling_toast\":null,\"limiters\":null,\"attic_info\":null,\"profile_edit_button\":null,\"elite_center\":{\"recommend_target\":\"GeneralESC\",\"candidates\":[{\"key\":\"GeneralESC\",\"biz\":1,\"title\":\"企业服务中心\",\"schema\":\"aweme://webview?url=https%3A%2F%2Fapi.amemv.com%2Finsights%2Felite%2Fmp_business_elite%2Fpages%2Fenterprise-service-center%2Findex.html%3Fhide_nav_bar%3D1%26allow_lmb%3D1%26container_bgcolor%3Dffffff%26status_font_dark%3D1%26enter_from%3DhomeSidebar\\u0026awe_falcon=sh\"}]},\"enterprise_card_visibility\":true,\"blue_label_edit_jump_url\":\"aweme://webview/?url=https%3A%2F%2Fapi.amemv.com%2Finsights%2Flite%2FcontactSetting%3Fhide_nav_bar%3D1%26title%3D%25E8%2581%2594%25E7%25B3%25BB%25E6%2596%25B9%25E5%25BC%258F%26enter_from%3Dcustomized_tab\\u0026hide_nav_bar=1\\u0026title=%E8%81%94%E7%B3%BB%E6%96%B9%E5%BC%8F\\u0026rn_schema=aweme%3A%2F%2Freactnative%2F%3Fchannel_name%3Drn_patch%26bundle_name%3Dbusiness%26module_name%3Dpage_e_lite_contactSetting%26force_h5%3D1%26hide_nav_bar%3D1%26bundle_url%3D%26title%3D%25E8%2581%2594%25E7%25B3%25BB%25E6%2596%25B9%25E5%25BC%258F%26enter_from%3Dcustomized_tab\"}",
      "enterprise_verify_reason": "店铺授权号",
      "evaluation_count": 0,
      "familiar_confidence": 0,
      "favorite_permission": 1,
      "favoriting_count": 0,
      "follow_guide": true,
      "follow_status": 0,
      "follower_count": 16322,
      "follower_request_status": 0,
      "follower_status": 0,
      "followers_detail": [
        {
          "app_name": "aweme",
          "apple_id": "1142110895",
          "download_url": "https://d.douyin.com/Y4Fy/",
          "fans_count": 16322,
          "icon": "https://p3.douyinpic.com/aweme-server-static-resource/follower_douyin_icon.png~tplv-obj.image",
          "name": "抖音",
          "open_url": "snssdk1128://user/profile/2483133812581103?",
          "package_name": "com.ss.android.ugc.aweme"
        },
        {
          "app_name": "news_article",
          "apple_id": "529092160",
          "download_url": "https://d.toutiao.com/fUN5/",
          "fans_count": 0,
          "icon": "https://p3.douyinpic.com/aweme-server-static-resource/follower_toutiao_icon.png~tplv-obj.image",
          "name": "头条",
          "open_url": "snssdk141://profile?uid=0?",
          "package_name": "com.ss.android.article.news"
        },
        {
          "app_name": "live_stream",
          "apple_id": "1086047750",
          "download_url": "http://d.huoshanzhibo.com/e7fw/",
          "fans_count": 0,
          "icon": "https://p3.douyinpic.com/aweme-server-static-resource/follower_hotsoon_icon.png~tplv-obj.image",
          "name": "抖音火山版",
          "open_url": "snssdk1112://profile?id=0",
          "package_name": "com.ss.android.ugc.live"
        }
      ],
      "following_count": 30,
      "forward_count": 0,
      "gender": 2,
      "general_permission": {
        "fans_page_toast": 0,
        "following_follower_list_toast": 1,
        "is_hit_active_fans_grayed": false
      },
      "has_e_account_role": true,
      "has_subscription": false,
      "hide_request_update": 0,
      "im_primary_role_id": 1001,
      "im_role_ids": [
        1001,
        1002,
        16,
        17,
        8,
        19,
        9,
        23,
        1100,
        35,
        42,
        54,
        1007,
        62,
        102,
        51
      ],
      "image_send_exempt": false,
      "ins_id": "",
      "ip_location": "IP属地：浙江",
      "is_activity_user": false,
      "is_ban": false,
      "is_block": false,
      "is_blocked": false,
      "is_effect_artist": false,
      "is_gov_media_vip": false,
      "is_im_oversea_user": 0,
      "is_mix_user": false,
      "is_not_show": false,
      "is_series_user": false,
      "is_sharing_profile_user": 0,
      "is_star": false,
      "life_story_block": {
        "life_story_block": false
      },
      "live_commerce": true,
      "live_status": 0,
      "location": "",
      "mate_add_permission": 1,
      "mate_relation": {
        "mate_apply_forward": 0,
        "mate_apply_reverse": 0,
        "mate_status": 0
      },
      "max_follower_count": 16731,
      "message_chat_entry": true,
      "mix_count": 0,
      "mplatform_followers_count": 16322,
      "nickname": "欧态官方旗舰店小K甄选",
      "no_recommend_user": false,
      "offline_info_list": [
        {
          "action": "https://fe.amemv.com/falcon/account_react/pages/cert_show/index.html?hide_nav_bar=1&enter_from=homepage_tag&short_id=24860150964",
          "link_type": "business_certificate",
          "offline_info_type": 11,
          "text": "授权资质"
        },
        {
          "offline_info_type": 9999,
          "text": "IP：浙江"
        }
      ],
      "original_musician": {
        "digg_count": 0,
        "music_card_data": {
          "artist_id": "0",
          "artist_name": "",
          "music_tab_style": 0,
          "self_switch": 1
        },
        "music_count": 0,
        "music_used_count": 0
      },
      "personal_tag_list": [
        {
          "personal_tag_type": 2,
          "text": "IP：浙江"
        }
      ],
      "pigeon_daren_status": "",
      "pigeon_daren_warn_tag": "0",
      "profile_component_disabled": [
        "banner_vs"
      ],
      "profile_mob_params": [
        {
          "event_key": "enter_personal_tab",
          "mob_params": "{\"landing_reason\":\"Landing_Default_Post\"}"
        }
      ],
      "profile_record_params": "{\"client_params\":{\"land_to\":1,\"from_uid\":0,\"to_uid\":2483133812581103,\"is_self\":false},\"business_params\":{\"has_stress_tag\":false,\"need_filter\":false,\"visitor_msg\":\"{\\\"from_uid\\\":0,\\\"to_uid\\\":2483133812581103,\\\"secret\\\":0,\\\"follow_status\\\":0,\\\"follower_status\\\":0,\\\"fans_threshold\\\":false,\\\"timestamp\\\":1773067057938409642,\\\"ab_status\\\":1,\\\"fans_ab_status\\\":1,\\\"profile_visited\\\":0,\\\"visitor_permission\\\":0,\\\"host_permission\\\":-1,\\\"shark_info\\\":\\\"{\\\\\\\"os_version\\\\\\\":\\\\\\\"14.4\\\\\\\",\\\\\\\"version_code\\\\\\\":290800,\\\\\\\"version_name\\\\\\\":\\\\\\\"\\\\\\\",\\\\\\\"device_type\\\\\\\":\\\\\\\"iPhone9,1\\\\\\\",\\\\\\\"aid\\\\\\\":1128,\\\\\\\"did\\\\\\\":7785613613782388,\\\\\\\"channel\\\\\\\":\\\\\\\"App Store\\\\\\\",\\\\\\\"device_platform\\\\\\\":\\\\\\\"iphone\\\\\\\",\\\\\\\"ip\\\\\\\":\\\\\\\"57.158.25.176\\\\\\\",\\\\\\\"target\\\\\\\":2483133812581103,\\\\\\\"user_agent\\\\\\\":\\\\\\\"r497ee1vxri6r7w407xke35\\\\\\\",\\\\\\\"uid\\\\\\\":0,\\\\\\\"app_name\\\\\\\":\\\\\\\"aweme\\\\\\\",\\\\\\\"iid\\\\\\\":0}\\\",\\\"to_user_type\\\":3}\"}}",
      "profile_show": {
        "identify_auth_infos": null
      },
      "profile_tab_info": {
        "profile_landing_tab": 0,
        "profile_tab_list": null,
        "profile_tab_list_v2": [
          {
            "id": 0,
            "name_en": "output"
          },
          {
            "id": 5,
            "name": "商家",
            "name_en": "homepage"
          }
        ]
      },
      "profile_tab_type": 0,
      "province": "",
      "public_collects_count": 0,
      "publish_landing_tab": 3,
      "r_fans_group_info": {},
      "recommend_reason_relation": "",
      "recommend_user_reason_source": 0,
      "risk_notice_text": "",
      "role_id": "00006,00439,00337,00014,01063,00888",
      "room_id": 0,
      "room_id_str": "0",
      "sec_uid": "MS4wLjABAAAAV0pW9WMKqO7LgvttqNA92O3Fsppnnwkh6vvs9Z9zPhMkQ6GPEi-at60BulpmZYnm",
      "secret": 0,
      "series_count": 0,
      "share_info": {
        "bool_persist": 1,
        "life_share_ext": "{\"life_share_id\":\"b9fe3e52b32f4178a9ef8be3298d149e\"}",
        "share_desc": "长按复制此条消息，打开抖音搜索，查看TA的更多作品。",
        "share_image_url": {
          "url_list": null
        },
        "share_qrcode_url": {
          "uri": "",
          "url_list": []
        },
        "share_title": "快来加入抖音，让你发现最有趣的我！",
        "share_url": "www.iesdouyin.com/share/user/MS4wLjABAAAAV0pW9WMKqO7LgvttqNA92O3Fsppnnwkh6vvs9Z9zPhMkQ6GPEi-at60BulpmZYnm?with_sec_did=1&sec_uid=MS4wLjABAAAAV0pW9WMKqO7LgvttqNA92O3Fsppnnwkh6vvs9Z9zPhMkQ6GPEi-at60BulpmZYnm&from_ssr=1&from_aid=1128&did=MS4wLjABAAAAuwXe8k-3i_MZuQ070ZuBrZb6PNpdBR9UioRWqE8ODmtYqzw9OFbGFe7aZ9oVjDfp&iid=MS4wLjABAAAANwkJuWIRFOzg5uCpDRpMj4OX-QryoDgn-yYlXQnRwQQ",
        "share_weibo_desc": "长按复制此条消息，打开抖音搜索，查看TA的更多作品。"
      },
      "short_id": "0",
      "show_favorite_list": false,
      "show_subscription": false,
      "signature": "【便宜】【好用】【准确度高】\n是我对欧态这个品牌的最深印象 \n这个号想要做到的是“更便宜… 更划算…”\n                                      —@控糖肌肉男小k",
      "signature_display_lines": 5,
      "signature_language": "un",
      "social_real_relation_type": 0,
      "special_follow_status": 0,
      "store_region": "cn-zj",
      "story_tab_empty": false,
      "sync_to_toutiao": 0,
      "tab_settings": {
        "enterprise_tab": {
          "show_tab_settings": true,
          "show_tab_style": 0,
          "tab_link": "aweme://lynxview/?enter_from=profile&hide_nav_bar=1&dynamic=1&is_editor=0&is_checking=0&loading_bgcolor=00000000&needReloadWithTheme=1&use_bdx=1&trans_status_bar=1&use_gecko_first=1&container_bgcolor=00000000&enable_font_scale=1&channel=mp_lynx_tab&page_enabled=1&page_priority=1&template_id=0&record_id=0&is_owner=0&sec_to_user_id=MS4wLjABAAAAV0pW9WMKqO7LgvttqNA92O3Fsppnnwkh6vvs9Z9zPhMkQ6GPEi-at60BulpmZYnm&to_user_id=2483133812581103&business_type=0&offline_info_count=0&surl=https%3A%2F%2Flf-dy-sourcecdn-tos.bytegecko.com%2Fobj%2Fbyte-gurd-source%2Faweme%2Fplatform%2Flynx%2Fmp_lynx_tab%2Ftemplate.js&bundle=template.js",
          "tab_type": 0,
          "title": "商家"
        },
        "private_tab": {
          "private_tab_style": 1,
          "show_private_tab": false
        }
      },
      "template_count": 0,
      "total_favorited": 12321,
      "total_favorited_correction_threshold": -1,
      "twitter_id": "",
      "twitter_name": "",
      "uid": "2483133812581103",
      "unique_id": "24860150964",
      "urge_detail": {
        "ctl_map": "{\"toast\":\"✅作者已收到“求更新”提醒～\",\"button_background_url\":\"https://p11-webcast.douyinpic.com/img/webcast/urge_update.png~tplv-obj.image\",\"urge_type\":\"\",\"dispose_to_moment\":\"0\",\"next_urge_type\":\"default\",\"button_text\":\"求更新\"}",
        "user_urged": 0
      },
      "use_diverse_digg_style": false,
      "user_age": 28,
      "user_not_see": 0,
      "user_not_show": 1,
      "user_permissions": [
        {
          "key": "douplus_user_type",
          "value": "2"
        }
      ],
      "verification_type": 0,
      "video_cover": {},
      "video_icon": {
        "height": 720,
        "uri": "",
        "url_list": [],
        "width": 720
      },
      "watch_status": false,
      "white_cover_url": [
        {
          "uri": "douyin-user-image-file/f7ca8cd4b55fe59ac7e6d74ce0045c10",
          "url_list": [
            "https://p3-sign.douyinpic.com/douyin-user-image-file/f7ca8cd4b55fe59ac7e6d74ce0045c10~tplv-dy-resize-walign-adapt-aq-pf:750:q82.heic?lk3s=93de098e&x-expires=1773237600&x-signature=li6Ryo6XDXiO1z6rdcWeXUJvkHI%3D&from=2480802190&s=profile&se=false&sc=cover&l=20260309223737D7B8B15960884E4C361B",
            "https://p26-sign.douyinpic.com/douyin-user-image-file/f7ca8cd4b55fe59ac7e6d74ce0045c10~tplv-dy-resize-walign-adapt-aq-pf:750:q82.heic?lk3s=93de098e&x-expires=1773237600&x-signature=BY75ajgMd6t0KVU4mAktv1b2MaU%3D&from=2480802190&s=profile&se=false&sc=cover&l=20260309223737D7B8B15960884E4C361B",
            "https://p9-sign.douyinpic.com/douyin-user-image-file/f7ca8cd4b55fe59ac7e6d74ce0045c10~tplv-dy-resize-walign-adapt-aq-pf:750:q82.heic?lk3s=93de098e&x-expires=1773237600&x-signature=zV6tdZJ9sODIhn3C2X20ntFw9FU%3D&from=2480802190&s=profile&se=false&sc=cover&l=20260309223737D7B8B15960884E4C361B",
            "https://p3-sign.douyinpic.com/douyin-user-image-file/f7ca8cd4b55fe59ac7e6d74ce0045c10~tplv-dy-resize-walign-adapt-aq-pf:750:q82.jpeg?lk3s=93de098e&x-expires=1773237600&x-signature=po1wiYpdzCSvSkS%2FqO4YEy5oqsA%3D&from=2480802190&s=profile&se=false&sc=cover&l=20260309223737D7B8B15960884E4C361B"
          ]
        },
        {
          "uri": "318f1000413827e122102",
          "url_list": [
            "https://p3-sign.douyinpic.com/318f1000413827e122102~tplv-dy-resize-walign-adapt-aq-pf:750:q82.heic?lk3s=93de098e&x-expires=1773237600&x-signature=1bkIIUqkQM%2FUcdirjchwDua2wZI%3D&from=2480802190&s=profile&se=false&sc=cover&l=20260309223737D7B8B15960884E4C361B",
            "https://p9-sign.douyinpic.com/318f1000413827e122102~tplv-dy-resize-walign-adapt-aq-pf:750:q82.heic?lk3s=93de098e&x-expires=1773237600&x-signature=XnKGwxN7sx9peayquijvhFf56cg%3D&from=2480802190&s=profile&se=false&sc=cover&l=20260309223737D7B8B15960884E4C361B",
            "https://p11-sign.douyinpic.com/318f1000413827e122102~tplv-dy-resize-walign-adapt-aq-pf:750:q82.heic?lk3s=93de098e&x-expires=1773237600&x-signature=wMcaCv7OrIMjcGHDMoYff1cEcDs%3D&from=2480802190&s=profile&se=false&sc=cover&l=20260309223737D7B8B15960884E4C361B",
            "https://p3-sign.douyinpic.com/318f1000413827e122102~tplv-dy-resize-walign-adapt-aq-pf:750:q82.jpeg?lk3s=93de098e&x-expires=1773237600&x-signature=Ypvi8Ws1NvTukJOyVG%2F1cdK5H4w%3D&from=2480802190&s=profile&se=false&sc=cover&l=20260309223737D7B8B15960884E4C361B"
          ]
        }
      ],
      "with_commerce_enterprise_tab_entry": false,
      "with_commerce_entry": true,
      "with_fusion_shop_entry": true,
      "with_new_goods": false,
      "youtube_channel_id": "",
      "youtube_channel_title": ""
    }
  }
}

💡 Note: For list data, the example shows only 1-2 items for simplicity. The actual count depends on the API response.

Douyin APIs - User Profile (V3) ​

Parameters ​

Code Samples ​

Responses ​

Douyin APIs - User Profile (V3)

Parameters

Code Samples

Responses