Douyin Xingtu Multi Get Author Info

4.13 credits/call
ae_douyin_xingtu_multi_get_author_info

Retrieve information for multiple creators in one call using their creator IDs. Inputs: - request_body (required): Object containing the lookup inputs. - request_body.author_ids (required): Array of creator ID strings. A maximum of 50 IDs is supported per call; exceeding the limit returns an error. Split larger lists into batches. - request_body.platform_source (optional): Integer platform source value; defaults to 1. - request_body.platform_channel (optional): Integer platform channel value; defaults to 1. Returns: Creator information in the response data. authors contains matched creators; not_exist_author_ids contains IDs that do not exist. The detailed fields of each creator record are not specified. This tool looks up known IDs rather than searching for creators by name or keyword.

Social
4.13 credits/call

Pricing

4.13 credits/call
ConditionCharge
Each call4.13 credits/call

4.13 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
request_bodyobjectYes批量查询创作者信息的请求体对象,包含创作者 ID 列表 author_ids,以及可选的平台来源 platform_source 和平台渠道 platform_channel。/ Request body object for retrieving information for multiple creators, containing the creator ID list author_ids and optional platform_source and platform_channel fields.—
request_body.author_idsarrayYes创作者ID列表,一次最多50个/Creator ID list, up to 50 per call—
request_body.platform_sourceintegerNo平台来源/Platform source1
request_body.platform_channelintegerNo平台渠道/Platform channel1

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_xingtu_multi_get_author_info' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "request_body": {
      "author_ids": [
        "7300290688967507978",
        "6966441588532707335",
        "7181083090893144122",
        "6870169257053782030",
        "7201505186169225277",
        "7357274847551946779",
        "7262210283295375420",
        "7259738005953314876",
        "6629723738763952136",
        "6694682244423876622",
        "6813914604083609607",
        "6871205324624232452"
      ]
    }
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": {
    "authors": [
      {
        "attribute_datas": {
          "author_id": "7300290688967507978",
          "author_status": "1",
          "avatar_uri": "https://p11.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-avt-0015_75b4b06253cc5f05d80b30109c4a94f9.jpeg?from=3782654143",
          "city": "哈尔滨",
          "core_user_id": "3262973273973896",
          "expected_play_num": "269337"
        },
        "star_id": "7300290688967507978"
      }
    ],
    "base_resp": {
      "status_code": 0,
      "status_message": ""
    },
    "not_exist_author_ids": []
  },
  "docs": "https://api.tikhub.io/#/Douyin-Xingtu-V2-API/multi_get_author_info_api_v1_douyin_xingtu_v2_multi_get_author_info_post",
  "message": "Request successful. This request will incur a charge.",
  "message_zh": "请求成功,本次请求将被计费。",
  "params": {}
}

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