Douyin Index Fetch Portrait

2.07 credits/call
ae_douyin_index_fetch_portrait

Retrieve an audience portrait for a keyword on Douyin or Toutiao within a specified date range. Inputs: - keyword (required): The keyword to analyze. - start_date (required): Start date as a YYYYMMDD string, for example "20260406". - end_date (required): End date as a YYYYMMDD string, for example "20260412". - app_name (optional): aweme for Douyin (default), or toutiao for Toutiao. Returns: Audience analysis in the response's data field, covering distributions such as gender, age, region, and interests. These describe the audience associated with the keyword for the selected platform and period. The exact dimensions and value formats depend on the returned data; the response schema does not define a fixed portrait structure, and data may be null.

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
keywordstringYes关键词/Keyword—
app_nameenum (aweme | toutiao)No平台/Platform: aweme(抖音), toutiao(头条)aweme
end_datestringYes结束日期/End date YYYYMMDD—
start_datestringYes开始日期/Start date YYYYMMDD—

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_index_fetch_portrait' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "end_date": "20261107",
    "keyword": "妈妈装",
    "start_date": "20261008"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": {
    "data": [
      {
        "label_list": [
          {
            "label_id": "110010410",
            "name_zh": "18-23",
            "tgi": 35.91098286889196,
            "value": 0.0458
          }
        ],
        "name_en": "age",
        "name_zh": "年龄"
      }
    ]
  },
  "docs": "https://api.tikhub.io/#/Douyin-Index-API/fetch_portrait_api_v1_douyin_index_fetch_portrait_post",
  "message": "Request successful. This request will incur a charge."
}

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