Douyin Get User Profile

2.07 credits/call
ae_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"}

Social
2.07 credits/call

Pricing

2.07 credits/call
ConditionCharge
Each call2.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.

ParameterTypeRequiredDescriptionDefault
sec_user_idstringYes必填:用户主页链接中 /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.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --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"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.