Douyin Fetch Batch User Profile V1

61.96 credits/call
ae_douyin_fetch_batch_user_profile_v1

Retrieve Douyin profile information for up to 10 users in one request. Input: sec_user_ids is required. Provide the users' sec_user_id values as one comma-separated string, not an array, with no more than 10 IDs. Result: Returns a response containing the batch user profile data in data, together with response status information. The data field may be null, and the documented schema does not specify the individual profile fields.

Social
61.96 credits/call

Pricing

61.96 credits/call
ConditionCharge
Each call61.96 credits/call

61.96 credits/call 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_idsstringYes用户sec_user_id列表,用逗号分隔/User sec_user_id list, separated by commas—

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_fetch_batch_user_profile_v1' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "sec_user_ids": "Cif2gmvVHUlxCYi8rRqVzJOIKvb5IcwtWicGfMRxmJd9nNBVS8kALYAaSQo8AAAAAAAAAAAAAFEflDEIG9PVXgXNY8OSZ9CUUonQeu-0xEuJeKqqa3bR-Z5f5jZ_rCmpq7Cpze7n0Kl6EOSfoQ4Yw8WD6gQiAQMuhYRi,CifYPHaniO-NWj2tokWbs13mtzipb5s7-wSjHpnuQtg7Ds0uwAtZ1iQaSQo8AAAAAAAAAAAAAFEflDEIG9PVXgXNY8OSZ9CUUonQeu-0xEuJeKqqa3bR-Z5f5jZ_rCmpq7Cpze7n0Kl6EPyeoQ4Yw8WD6gQiAQN9OnlA,Cifg82QyR3fwU5LB4mvALKhKfmiCQJwUXfd6yk5Kx7u7UJ2vuq51sv8aSQo8AAAAAAAAAAAAAFEflDEIG9PVXgXNY8OSZ9CUUonQeu-0xEuJeKqqa3bR-Z5f5jZ_rCmpq7Cpze7n0Kl6EP-eoQ4Yw8WD6gQiAQMWNdj6,CicJS5cTMAMyvKvkSzVoLYp2t4vWq3kol5DrS3PfZ9xCeGtR8eAbD-oaSQo8AAAAAAAAAAAAAFEflDEIG9PVXgXNY8OSZ9CUUonQeu-0xEuJeKqqa3bR-Z5f5jZ_rCmpq7Cpze7n0Kl6EM-eoQ4Yw8WD6gQiAQNTFtBJ,Cidr0sCYPgAR6M0HhsT9-buTUtTrOrqsNCnqqBMR4sCEe9pdG0MyWD8aSQo8AAAAAAAAAAAAAFEflDEIG9PVXgXNY8OSZ9CUUonQeu-0xEuJeKqqa3bR-Z5f5jZ_rCmpq7Cpze7n0Kl6EJmdoQ4Yw8WD6gQiAQNJZ-IP,Cie0xL0DvVRDx3iyS435FR7OFe0XX2SM11FbGcxa6C1rFPJkw0wHLK0aSQo8AAAAAAAAAAAAAFEflDEIG9PVXgXNY8OSZ9CUUonQeu-0xEuJeKqqa3bR-Z5f5jZ_rCmpq7Cpze7n0Kl6EJKdoQ4Yw8WD6gQiAQNGttLV,CifcFSDeoXnim9igX-jUJrq8PP_Nah2HVF0MUSc2z5VoD3FsXQWi63gaSQo8AAAAAAAAAAAAAFEflDEIG9PVXgXNY8OSZ9CUUonQeu-0xEuJeKqqa3bR-Z5f5jZ_rCmpq7Cpze7n0Kl6ELOdoQ4Yw8WD6gQiAQNQrYkP"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": [],
  "docs": "https://api.tikhub.io/#/Douyin-Web-API/fetch_batch_user_profile_v1_api_v1_douyin_web_fetch_batch_user_profile_v1_get",
  "message": "Request successful. This request will incur a charge.",
  "message_zh": "请求成功,本次请求将被计费。",
  "params": {
    "sec_user_ids": "Cif2gmvVHUlxCYi8rRqVzJOIKvb5IcwtWicGfMRxmJd9nNBVS8kALYAaSQo8AAAAAAAAAAAAAFEflDEIG9PVXgXNY8OSZ9CUUonQeu-0xEuJeKqqa3bR-Z5f5jZ_rCmpq7Cpze7n0Kl6EOSfoQ4Yw8WD6gQiAQMuhYRi,CifYPHaniO-NWj2tokWbs13mtzipb5s7-wSjHpnuQtg7Ds0uwAtZ1iQaSQo8AAAAAAAAAAAAAFEflDEIG9PVXgXNY8O"
  }
}

This example shows part of the response. Copied content is valid JSON.