[中文]

用途:

获取指定 TikTok 视频观众的用户画像统计数据，包括性别分布、年龄分布、地区分布等维度。

可用于精准了解视频观众群体特征，指导内容创作、商品选择和营销策略优化。

支持按时间段（日/周/月）分析变化趋势。

备注:

此接口需要提供 item_id（视频 ID）。

受众画像数据来源于观看和互动用户的统计特征。

参数:

cookie: 用户 Cookie 字符串（用于身份认证）

start_date: 查询起始日期，格式为 'MM-DD-YYYY'，如 '04-01-2025'

item_id: 视频 ID，例如 "7496499484705246507"

proxy: 可选 HTTP 代理地址，如不使用可省略

示例格式: http://username:password@host:port

返回内容说明:

segments（数据分段列表）:

time_selector: 时间筛选参数（period, granularity, start_timestamp, end_timestamp）

filter: 查询条件（creator_id, item_id）

timed_profile: 分段画像统计数据

start_timestamp: 开始时间戳

end_timestamp: 结束时间戳

stats:

follower_genders: 性别分布

key: 性别（female/male）

value: 占比（字符串，0-1）

follower_ages: 年龄段分布

key: 年龄段（如 "18-24", "25-34", 等）

value: 占比（字符串，0-1）

follower_regions: 地区分布

key: 国家代码（如 "US"）

value: 占比（字符串，0-1）

profile_type: 画像类型，固定值 2（受众画像）

示例请求体:

{
  "cookie": "your_cookie",
  "start_date": "04-01-2025",
  "item_id": "7496499484705246507"
}

[English]

Purpose:

Retrieve audience profile statistics for a specified TikTok video, including gender distribution, age distribution, and regional distribution.

Useful for accurately understanding the characteristics of the video audience to guide content creation, product selection, and marketing strategy optimization.

Supports trend analysis across different time intervals (daily/weekly/monthly).

Notes:

Requires item_id (video ID).

Audience profile data is based on characteristics of users who viewed and interacted with the video.

Return Description:

segments:

time_selector: Time filtering parameters (period, granularity, start_timestamp, end_timestamp)

filter: Query conditions (creator_id, item_id)

timed_profile: Audience profile statistics

start_timestamp: Start timestamp

end_timestamp: End timestamp

stats:

follower_genders: Gender distribution

key: Gender ("female" or "male")

value: Proportion (string, range 0-1)

follower_ages: Age group distribution

key: Age group (e.g., "18-24", "25-34")

value: Proportion (string, range 0-1)

follower_regions: Regional distribution

key: Country code (e.g., "US")

value: Proportion (string, range 0-1)

profile_type: Profile type, fixed value 2 (Audience Profile)

Example Request Body:

{
  "cookie": "your_cookie",
  "start_date": "04-01-2025",
  "item_id": "7496499484705246507"
}

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Example

{
    "cookie": "Your_Cookie_String",
    "proxy": "string",
    "start_date": "04-01-2025",
    "item_id": "string"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Successful Response

Body

Example

{
    "code": 200,
    "request_id": "string",
    "message": "Request successful. This request will incur a charge.",
    "message_zh": "请求成功，本次请求将被计费。",
    "support": "Discord: https://discord.gg/aMEAS8Xsvz",
    "time": "string",
    "time_stamp": 0,
    "time_zone": "America/Los_Angeles",
    "docs": "string",
    "cache_message": "string",
    "cache_message_zh": "string",
    "cache_url": "string",
    "router": "",
    "params": {},
    "data": null
}

🟠422Parameter Error

获取视频受众分析数据/Get Video Audience Analysis Data

[中文]#

用途:#

备注:#

参数:#

返回内容说明:#

示例请求体:#

[English]#

Purpose:#

Notes:#

Return Description:#

Example Request Body:#

Request

Request Code Samples

Responses

[中文]

用途:

备注:

参数:

返回内容说明:

示例请求体:

[English]

Purpose:

Notes:

Return Description:

Example Request Body: