tiktok-creative-center/
creator-cards

按创作者市场 ID 查询最多 20 位 TikTok 达人的名片:粉丝的年龄、性别、国家和设备占比,中位播放量、互动率、增长率,以及列出的起步报价。

TikTok Creator Marketplace API

最多 20 位创作者
受众画像
起步报价
每条结果 0.5 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

TikTok Creator Marketplace

TikTok 创作者市场(达人广场)的名片,是品牌评估达人付费合作时看到的资料页,包含达人的简介和粉丝数,粉丝的年龄、性别、国家和设备分布,中位播放量、互动率和增长率,以及达人为赞助视频列出的起步报价。品牌可以在同一个视图里比较达人的受众匹配度、日常表现和价格。

TikTok Creator Marketplace API 主要特性

  • 四个维度的粉丝画像audience 按年龄段、性别、国家和手机品牌拆分粉丝,每一项都是 0 到 1 的占比。
  • 表现基准metrics 包含 followers_count、median_views、engagement_rate、followers_growth_rate 和 six_second_view_rate。
  • 列出的起步报价starting_price 返回达人为赞助视频列出的金额和币种,金额是可以直接计算的数字。
  • 一次最多 20 位达人creator_ids 填 1 到 20 个创作者市场 ID,每位有名片的达人返回一条记录。
  • 每张名片都带身份信息username、name、简介 text、avatar_url、region、tiktok_user_id、url 和 recent_video_ids 能把市场 ID 对回真实账号。

TikTok Creator Marketplace API 参数

参数必填描述
creator_ids必填1 到 20 个创作者市场 ID,例如 TikTok Creative Center Top Videos 结果中的 creator_id。

如何使用 TikTok Creator Marketplace API

先从 Top Videos 收集创作者 ID,再读取他们的名片。

  1. 调用 TikTok Creative Center Top Videos,复制想评估的创作者的 creator_id。
  2. 向 /v1/tiktok-creative-center/creator-cards 发送 {"creator_ids": ["7011198409688219653", "7070293872819044358"]}。
  3. 轮询 GET /v1/tasks/{task_id},直到 status 变成 succeeded,从 results.items 读取每位创作者的名片。
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/creator-cards" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"creator_ids":["7011198409688219653","7070293872819044358"]}'

# audience 下的 ages、genders、countries 和 devices 都是 0 到 1 的占比。

TikTok Creator Marketplace API 最佳使用场景

  • 受众匹配筛选: 把候选达人的 audience.ages、genders 和 countries 与目标客户对照,剔除粉丝不在目标市场的达人。
  • 单位播放成本比较: 用 starting_price.amount 除以 median_views,比较各位达人标价能买到多少播放,而不是比粉丝数。
  • 势头排序: 候选名单按 engagement_rate 和 followers_growth_rate 排序,找出互动好又仍在涨粉的达人。

TikTok Creator Marketplace API 使用建议

  • ID 取自 Top Videos 记录里的 creator_id;author.id 这样的 TikTok 用户 ID 对应不到名片,会被跳过。
  • 每个画像维度是一组占比,加起来可能略小于 1,用 label 对应条目,不要按位置取值。
  • starting_price.amount 要连同 currency 一起读,并把它当作达人的起步价,最终价格按项目协商。

除了 TikTok Creator Marketplace API,需要其他类型的 TikTok Creative Center 公开数据时,可以使用以下 API。

探索其他平台

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

TikTok Creator Marketplace API — 常见问题

TikTok Creator Marketplace API 是一个用于按创作者市场 ID 获取最多 20 位达人的 TikTok Creator Marketplace 名片的 API。它返回粉丝年龄、性别、国家和设备占比,中位播放量、互动率和增长率,起步报价以及达人身份信息。

传创作者市场 ID,也就是 Top Videos 记录里的 creator_id,格式是 5 到 32 位数字。普通的 TikTok 用户 ID 对应不到名片,其他格式会被以 400 错误拒绝。

加入了 TikTok 创作者市场并填好资料的达人;入驻资格由 TikTok 规定,年龄和粉丝门槛因项目而异。没有名片的 ID 会被跳过且不收费,全部被跳过时任务失败、积分退回。每张返回的名片 0.5 积分。

四个维度:年龄段(如 18-24、55+)、性别、国家和手机品牌,每项都是 0 到 1 的占比。国家还带 country_code 和抽样粉丝数 count。

starting_price 给出达人为赞助视频列出的起步金额和币种。它只是起点,起步价由达人自己设定,最终价格按项目协商。

不能,这里是按创作者市场 ID 查询。候选达人可以从 TikTok Creative Center Top Videos 找起,榜单的每条记录都带 creator_id。

不需要。查询只靠你的 SocQ API key,不涉及 TikTok 的品牌账号或合作伙伴审批。