Douyin Index Fetch Content Consumer Portrait

2.07 credits/call
ae_douyin_index_fetch_content_consumer_portrait

Get the audience portrait for people who watch Douyin videos in a specific content category. Here, “consumers” means viewers, not purchasers; this tool describes the audience rather than content creators. Inputs: - tag_id (required): A specific category ID as a string. "0" (all categories) is not supported. Category IDs can be obtained from the category filter options. - end_date (required): End date in YYYYMMDD format, aligned with the selected period. - period (optional): "week" or "month"; defaults to "month". Weekly dates must be Sundays, and monthly dates must be the last day of the month. Returns audience distributions such as gender, age group, region, interests, and devices. The detailed structure of the returned data is not specified, so available fields should be read from the actual result. Example: tag_id="601", period="month", end_date="20260331".

Social
2.07 credits/call

Pricing

2.07 credits/call
ConditionCharge
Each call2.07 credits/call

2.07 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
periodenum (week | month)No时间粒度/Period: week or monthmonth
tag_idstringYes垂类ID,**必填,不支持 0=全部**(同 fetch_item_query 的 category_id 但不接受 0)/Category ID, **required, does NOT support 0=all**. Get full list via fetch_item_filter_options (excluding id=0)—
end_datestringYes结束日期/End 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_content_consumer_portrait' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "end_date": "20261031",
    "period": "month",
    "tag_id": "624"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": {
    "BaseResp": {
      "StatusCode": 0
    },
    "interaction_data": [
      {
        "label_list": [
          {
            "label_id": "null",
            "name_zh": "18-23",
            "rate": 0.13451873599580996,
            "tgi": 98.5440889505163
          }
        ],
        "name_en": "age"
      }
    ],
    "play_data": [
      {
        "label_list": [
          {
            "label_id": "null",
            "name_zh": "18-23",
            "rate": 0.12203667375895681,
            "tgi": 98.15384103835459
          }
        ],
        "name_en": "age"
      }
    ]
  },
  "docs": "https://api.tikhub.io/#/Douyin-Index-API/fetch_content_consumer_portrait_api_v1_douyin_index_fetch_content_consumer_portrait_post",
  "message": "Request successful. This request will incur a charge.",
  "message_zh": "请求成功,本次请求将被计费。",
  "request_id": "d96aa61c-9d52-4626-8dda-e8e87624ac14"
}

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