Douyin Get User Profile
Retrieve information about a specified Douyin user. Input: sec_user_id (required string). Use the identifier after /user/ in an accessible profile URL such as https://www.douyin.com/user/{sec_user_id}. Supply only the identifier, not the full URL, Douyin ID, or uid. Result: A response containing the user's information in data. The data value may be null, and specific profile fields are not guaranteed by the response schema. Example: {"sec_user_id":"USER_SEC_ID"}
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
Each call has a fixed fee of 2.07 credits. Charges are per query. A successful query is billed even if it returns no results.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
sec_user_id | string | Yes | 必填:用户主页链接中 /user/ 后的 sec_user_id,不是抖音号或 uid/Required: sec_user_id after /user/ in the profile URL, not the Douyin ID or uid | — |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_douyin_get_user_profile' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"sec_user_id": "MS4wLjABAAAAv2FCyofr02-KJuqKEA2ceoTus3MRsoMVI-GEWWS_W8Tz2WB7Ihoshhq-vkbCedMc"
}
}'{
"code": 200,
"data": {
"extra": {
"fatal_item_ids": [],
"logid": "[REDACTED]",
"now": 1794416073000
},
"log_pb": {
"impr_id": "[REDACTED]"
},
"status_code": 0,
"status_msg": null,
"user": {
"account_cert_info": "{}",
"apple_account": 0,
"avatar_168x168": {
"height": 720,
"uri": "aweme-avatar/tos-cn-i-0813c001_o0eOLNgmiiA1zAIqAMAWI6EEfiADxCADLB29xi",
"url_list": [
"https://p3-pc.douyinpic.com/img/aweme-avatar/tos-cn-i-0813c001_o0eOLNgmiiA1zAIqAMAWI6EEfiADxCADLB29xi~c5_168x168.jpeg?from=2956013662"
],
"width": 720
},
"avatar_300x300": {
"height": 720,
"uri": "aweme-avatar/tos-cn-i-0813c001_o0eOLNgmiiA1zAIqAMAWI6EEfiADxCADLB29xi",
"url_list": [
"https://p3-pc.douyinpic.com/img/aweme-avatar/tos-cn-i-0813c001_o0eOLNgmiiA1zAIqAMAWI6EEfiADxCADLB29xi~c5_300x300.jpeg?from=2956013662"
],
"width": 720
},
"avatar_larger": {
"height": 720,
"uri": "aweme-avatar/tos-cn-i-0813c001_o0eOLNgmiiA1zAIqAMAWI6EEfiADxCADLB29xi",
"url_list": [
"https://p3-pc.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-i-0813c001_o0eOLNgmiiA1zAIqAMAWI6EEfiADxCADLB29xi.jpeg?from=2956013662"
],
"width": 720
},
"avatar_medium": {
"height": 720,
"uri": "aweme-avatar/tos-cn-i-0813c001_o0eOLNgmiiA1zAIqAMAWI6EEfiADxCADLB29xi",
"url_list": [
"https://p3-pc.douyinpic.com/aweme/720x720/aweme-avatar/tos-cn-i-0813c001_o0eOLNgmiiA1zAIqAMAWI6EEfiADxCADLB29xi.jpeg?from=2956013662"
],
"width": 720
}
}
},
"docs": "https://api.tikhub.io/#/Douyin-Web-API/handler_user_profile_api_v1_douyin_web_handler_user_profile_get",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"params": {
"sec_user_id": "MS4wLjABAAAAv2FCyofr02-KJuqKEA2ceoTus3MRsoMVI-GEWWS_W8Tz2WB7Ihoshhq-vkbCedMc"
}
}This example shows part of the response. Copied content is valid JSON.

