登录开始免费试用
easyCoexistence 官方 API

通过 API 获取 TikTok 受众画像

TikTok API for Business 通过 GET /business/get/ 返回账户的粉丝画像:audience_ages、audience_genders、audience_countries 和 audience_cities,每项均为粉丝占比列表,适用于粉丝数至少 100 的账户。每小时粉丝活跃度以 audience_activity 的形式位于每日 metrics 中,适用于拥有 Advanced Access 或 Verified Business Accounts、且粉丝数同样至少为 100 的账户。以上均需要 user.insights 权限范围。

easyCoexistence 可从 Claude、ChatGPT 或您自己的代码中,通过 get_social_insights 读取 TikTok 账户的粉丝画像:请求 audience_ages、audience_genders、audience_countries、audience_cities 或 audience_activity,它会原样返回 TikTok 的列表。

100

账户在 TikTok 返回年龄、性别、国家和城市细分之前所需的粉丝数。

5 groups

audience_ages 中的年龄段:18-24、25-34、35-44、45-54 和 55+。

UTC+0

audience_activity 的时区,表示每小时在 TikTok 上活跃的粉丝数量。

24 to 48 h

audience_countries、audience_genders 和 audience_activity 的通常延迟,这些数据由 TikTok 离线计算。

账户端点会返回哪些受众画像?

在 fields 中指定字段名时,GET /business/get/ 会返回这些数据。四项细分位于 data 顶层,每个维度一个列表;每小时活跃度则位于 metrics 中,每天一组:

  • audience_ages:各年龄段粉丝的占比,分别为 18-24、25-34、35-44、45-54 和 55+。
  • audience_genders:按性别划分的粉丝占比:Female、Male 或 Other。
  • audience_countries:按国家或地区划分的粉丝占比,使用 ISO 3166-1 alpha-2 代码。
  • audience_cities:按 city_name 划分的城市粉丝占比。
  • audience_activity:每天各小时在 TikTok 上活跃的粉丝,以 hour 和 count 表示。

如何请求这些数据?

在 fields 中填写字段名(采用 JSON 数组),并为携带 audience_activity 的每日 metrics 指定 UTC 日期范围。start_date 和 end_date 最多可回溯 60 天;若未提供,TikTok 将返回请求日前一天往前的 7 天数据。

Follower demographics for a TikTok account
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/get/' \
  -H 'Access-Token: <ACCESS_TOKEN>' \
  --data-urlencode 'business_id=<OPEN_ID>' \
  --data-urlencode 'fields=["audience_ages","audience_genders","audience_countries","audience_cities","audience_activity"]' \
  --data-urlencode 'start_date=2026-10-24' \
  --data-urlencode 'end_date=2026-10-30'

响应是什么样的?

每项细分是一个对象列表,将分组与其百分比配对;metrics 中的每一天都带有日期和 audience_activity 小时列表。以下数值为 TikTok 的示例,仅保留性别列表和若干小时。

Demographics in the /business/get/ response
{
  "code": 0,
  "message": "OK",
  "request_id": "<REQUEST_ID>",
  "data": {
    "audience_genders": [
      { "gender": "Female", "percentage": 0.7554470336505679 },
      { "gender": "Male", "percentage": 0.24455296634943213 }
    ],
    "metrics": [
      {
        "date": "<DATE>",
        "audience_activity": [
          { "hour": "20", "count": 1 },
          { "hour": "23", "count": 4 },
          { "hour": "7", "count": 4 }
        ]
      }
    ]
  }
}

哪些账户能获得哪些细分?

年龄、性别、国家和城市占比需要账户至少拥有 100 名粉丝才会返回;TikTok 对一个 13 粉丝账户的示例中,这些列表为空。audience_activity 同样需要 100 名粉丝,此外账户还需具备 Advanced Access(通过关联 TikTok for Business 账户或未认证的 Business Center 获得),或为 Verified Business Account。以上所有字段都需要访问令牌具备 user.insights 权限范围。

受众画像的数据有多新?

通常滞后一到两天。TikTok 将 audience_countries、audience_genders 和 audience_activity 列为通常滞后 24 至 48 小时的字段,时间以 UTC 计;年龄和城市的更新时间相同。数据来自 TikTok Analytics,账户所有者需在发布第一条视频后于应用中开启该功能,之前的数据不可用。TikTok 基于多种因素计算受众画像,包括用户在个人资料中填写的内容。

粉丝画像与视频观看者有何不同?

两者描述的是不同人群。账户列表涵盖粉丝。/business/video/list/ 返回的是观看某条帖子的人群细分:audience_genders、audience_countries 和 audience_cities,每项最多 10 条;另有 audience_types,将观看者分为新观看者和回访者、粉丝和非粉丝。这些需要 video.insights 权限范围,而非 user.insights。

easyCoexistence 如何读取这些数据?

对账户使用 get_social_insights:省略 object_id,将字段名列为 metrics,若需特定日期的 audience_activity,则在 params 中传入 start_date 和 end_date。它会原样返回 TikTok 的列表,因此占比和小时数与上文所述完全一致。

Follower demographics through MCP
get_social_insights {
  "account_id": "<ACCOUNT_ID>",
  "metrics": ["audience_ages", "audience_genders", "audience_countries", "audience_cities", "audience_activity"],
  "params": { "start_date": "2026-10-24", "end_date": "2026-10-30" }
}

常见错误

  • 预期小账户也能获得细分。TikTok 从 100 名粉丝起才返回年龄、性别、国家和城市占比;其 13 粉丝账户的示例中,这些列表为空。
  • 把 audience_activity 的小时当作本地时间。TikTok 以 UTC+0 报告,因此在规划发帖前,请先换算为受众所在的时区。
  • 把粉丝画像当作观看者画像。账户列表描述的是粉丝;视频的 audience_countries 描述的是观看该视频的人。
  • 期望个人账户可获得 audience_activity。TikTok 仅向拥有 Advanced Access 或 Verified Business Accounts、且粉丝至少 100 名的账户返回该数据。
使用 EasyCoexistence 完成这些操作

每个连接每月 US$ 9 起,连接越多越便宜,最低降至 US$ 0.75,并提供前 3 天免费试用。

常见问题

TikTok API 能显示我粉丝的年龄和性别吗?

可以。/business/get/ 会返回 audience_ages 和 audience_genders,即各组粉丝的占比;前提是账户至少有 100 名粉丝,且访问令牌具有 user.insights 权限范围。

TikTok API 使用哪些年龄段?

18-24、25-34、35-44、45-54 和 55+,每段均附有该段粉丝的占比。

TikTok API 能显示我的粉丝何时在线吗?

audience_activity 在每日 metrics 中以 UTC+0 时间给出每小时在 TikTok 上活跃的粉丝数,适用于拥有 Advanced Access 或 Verified Business Accounts 且粉丝数至少 100 名的账户。

TikTok API 如何提供粉丝所在的国家?

通过 audience_countries 以 ISO 3166-1 alpha-2 国家或地区代码的形式提供,并附有来自该地区的粉丝占比。

继续阅读

两分钟连接您的第一个渠道。

无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。

  • 免费试用 3 天
  • 随时取消
  • 仅使用官方 API
  • 全天候 24/7 监控

验证时间