TItikhub
Douyin-Index-API

获取视频观众分析/Get video audience profile

Changed on

[中文]

用途:

  • 获取指定视频的观众人群画像

参数:

  • item_id: 视频ID（抖音 aweme id，纯数字字符串）
  • start_date: 开始日期，格式 YYYYMMDD
  • end_date: 结束日期，格式 YYYYMMDD

返回:

  • 观众性别分布、年龄分布、地域分布、兴趣分布等画像数据

[English]

Purpose:

  • Get the audience portrait for a video

Parameters:

  • item_id: Video ID (Douyin aweme id, numeric string)
  • start_date/end_date: Date range in YYYYMMDD

Return:

  • Audience gender, age, region, interest distributions and other portrait data

[示例/Example]

item_id = "7660090930283744575" start_date = "20260704" end_date = "20260710"

post/api/v1/douyin/index/fetch_item_user_profile

Request

  • Base URL
    https://api.tikhub.io (the document declares no server; this is the origin it was published from)
  • Auth
    HTTP bearer

Query parameters

item_idstring required

视频ID（抖音 aweme id，纯数字）/Video ID (Douyin aweme id, numeric). Example: 7660090930283744575

start_datestring required

开始日期/Start date YYYYMMDD

end_datestring required

结束日期/End date YYYYMMDD

Response

Successful Response

codeinteger

HTTP status code | HTTP状态码

request_idstring nullable

Unique request identifier | 唯一请求标识符

messagestring

Response message (EN-US) | 响应消息 (English)

message_zhstring

Response message (ZH-CN) | 响应消息 (中文)

supportstring

Support message | 支持消息

timestring

The time the response was generated | 生成响应的时间

time_stampinteger

The timestamp the response was generated | 生成响应的时间戳

time_zonestring

The timezone of the response time | 响应时间的时区

docsstring nullable

Link to the API Swagger documentation for this endpoint | 此端点的 API Swagger 文档链接

cache_messagestring nullable

Cache message (EN-US) | 缓存消息 (English)

cache_message_zhstring nullable

Cache message (ZH-CN) | 缓存消息 (中文)

cache_urlstring nullable

The URL to access the cached result | 访问缓存结果的 URL

routerstring

The endpoint that generated this response | 生成此响应的端点

paramsunknown
dataunknown

Changes