tiktok/
user-audience

只需用户名,就能查看任意公开 TikTok 账号的粉丝来自哪些国家,返回每个国家的名称、ISO 代码、粉丝占比和抽样粉丝数。

TikTok Audience Demographics API

用户名输入
粉丝所在国家
各国占比
每次请求 20 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

TikTok Audience Demographics

TikTok 账号的受众国家,说明它的粉丝分布在哪里:每个国家用粉丝样本中的占比,以及占比背后的抽样人数来表示。TikTok 自带的数据分析只对账号本人开放,所以品牌、代理机构和分析师想了解不属于自己的创作者,就得靠用户名来查询。

TikTok Audience Demographics API 主要特性

  • 公开用户名即可查,无需登录提交公开账号的用户名,带不带 @ 都行,不需要账号权限,也不需要登录 TikTok,就能拿到它的粉丝地区分布。
  • 国家名、ISO 代码、占比与人数audience_countries 的每一项包含国家名称、两位字母的 country_code、0 到 1 之间的 share,以及对应的抽样粉丝数 count。
  • 从最大的市场往下排国家按占比从高到低返回,前几行就能说明大部分粉丝在哪里,靠后的则是体量较小的市场。

TikTok Audience Demographics API 参数

参数必填描述
username必填要分析的 TikTok 用户名,开头的 @ 可带可不带。

如何使用 TikTok Audience Demographics API

提交用户名,轮询任务,读取一条受众记录。

  1. 向 /v1/tiktok/user-audience 发送 {"username": "khaby.lame"}。
  2. 每隔几秒轮询 GET /v1/tasks/{task_id},直到 status 变成 succeeded。
  3. 读取 results.items 中的那条记录,遍历 audience_countries。
curl -X POST "https://api.socq.ai/v1/tiktok/user-audience" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"khaby.lame"}'

# 结果只有一条记录;audience_countries[].share 是 0 到 1 之间的小数。

TikTok Audience Demographics API 最佳使用场景

  • 为单一市场挑选达人: 为面向某个国家的投放付费之前,先看这个国家在达人粉丝中占多大比例;粉丝再多,如果都在别的国家,也触达不到你的买家。
  • 验证定向投放有没有效果: 想在一个新国家做起受众时,定期用同一个用户名查询,对比不同 collected_at 之间该国家占比的变化。
  • 排除无法服务的市场: 只在固定几个国家销售或发货的店铺和应用,可以把这些 country_code 的占比加总,把粉丝大多在服务范围之外的达人剔掉。

TikTok Audience Demographics API 使用建议

  • 用 count 除以 share 就能估出粉丝样本有多大;样本很小时,占比相近的国家当作并列,不要硬排名次。
  • 对比达人之前,先把 country_code 归并成你自己的区域,比如欧盟或拉美,因为投放通常面向一个区域,而不是单个国家。

除了 TikTok Audience Demographics API,需要其他类型的 TikTok 公开数据时,可以使用以下 API。

  • TikTok Profiles API — 按 username 获取公开主页身份、简介、账号标记和受众计数。
  • TikTok Followers List API — 采集公开粉丝列表中可见的标准化资料,并保留来源上下文和支持的指标。
  • TikTok Following List API — 采集 TikTok 账号公开可见的关注对象,返回标准化身份、简介、可见指标和来源账号信息。
  • TikTok User Videos API — 按 username 采集公开个人资料视频,返回文案、创作者、媒体、时间、互动和来源账号上下文。
  • TikTok Similar Accounts API — 按用户名获取 TikTok 推荐的相似账号,附带粉丝数和简介。
  • TikTok Live Ranking API — 获取直播日榜,包含名次、按礼物计算的分值和粉丝数。

探索其他平台

还可以将 TikTok 数据与其他已支持社交平台的公开数据结合使用。

TikTok Audience Demographics API — 常见问题

TikTok Audience Demographics API 是一个用于根据用户名获取公开 TikTok 账号粉丝所在国家的 API。它返回一条记录,列出每个国家的名称、ISO 代码、粉丝占比和抽样粉丝数。

只要账号是公开的,提交它的用户名即可。TikTok 里只有账号本人能看到粉丝所在地区,而这个查询除了用户名什么都不需要。

不能。记录只覆盖粉丝所在的国家,没有年龄、性别和城市的拆分。

可以,提交你自己的用户名,直接拿到数据形式的国家列表,不必再打开 TikTok 的数据分析页面,管理多个账号、要做报表时尤其省事。

每个占比都来自账号粉丝的一份样本,count 表示占比背后有多少抽样粉丝。count 很小的国家只能当作大致参考,不是精确数字。

按请求收费。一个用户名固定 20 积分,不管返回多少个国家;用户名不存在时任务会失败,积分退回。