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.
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 |
|---|---|---|---|---|
keyword | string | Yes | 关键词/Keyword | — |
app_name | enum (aweme | toutiao) | No | 平台/Platform: aweme(抖音), toutiao(头条) | aweme |
end_date | string | Yes | 结束日期/End date YYYYMMDD | — |
start_date | string | Yes | 开始日期/Start date YYYYMMDD | — |
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_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"
}
}'{
"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.

