Douyin-Index-API
消费者画像/Content consumer portrait
Changed on[中文]
用途:
- 获取指定垂类下消费者人群画像(即"观看该垂类视频的用户"画像)
- 与 fetch_content_author_portrait 互为补充:一个看作者,一个看观众
参数:
- tag_id: 垂类ID(必填,不支持 0=全部,需传入具体垂类 ID,可通过 fetch_item_filter_options 获取)
- period: 时间粒度,"week"=按周(end_date 必须为周日), "month"=按月(end_date 必须为月末,如 20260331)
- end_date: 结束日期 YYYYMMDD,需与 period 对齐
返回:
- 消费者画像数据:性别分布、年龄段分布、地域分布、兴趣偏好、设备分布等
[English]
Purpose:
- Get consumer (viewer) portrait for a category (i.e. profile of users who watch videos in this category)
- Counterpart to fetch_content_author_portrait: one for creators, one for viewers
Parameters:
- tag_id: Category ID (required, does NOT support 0=all, must pass a specific category ID)
- period: "week" (end_date must be a Sunday) or "month" (end_date must be month-end, e.g. 20260331)
- end_date: End date YYYYMMDD, must align with period
Return:
- Consumer portrait: gender, age group, region, interest, device distributions
[示例/Example]
tag_id = "601" period = "month" end_date = "20260331"
post/api/v1/douyin/index/fetch_content_consumer_portrait
Request
- Base URLhttps://api.tikhub.io (the document declares no server; this is the origin it was published from)
- AuthHTTP bearer
Query parameters
tag_idstring required
垂类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)
period'week' | 'month'
时间粒度/Period: week or month
end_datestring required
结束日期/End date YYYYMMDD
Response
Successful Response
Changes
- info
added the optional property
//to the response with the status - info
added the optional property
//to the response with the status
- info
- info
endpoint added
- info