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,再读取他们的名片。
- 调用 TikTok Creative Center Top Videos,复制想评估的创作者的 creator_id。
- 向 /v1/tiktok-creative-center/creator-cards 发送 {"creator_ids": ["7011198409688219653", "7070293872819044358"]}。
- 轮询 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 一起读,并把它当作达人的起步价,最终价格按项目协商。
相关 API
除了 TikTok Creator Marketplace API,需要其他类型的 TikTok Creative Center 公开数据时,可以使用以下 API。
- TikTok Creative Center Top Ads API — 按关键词和时间范围浏览热门广告,返回文案、点击率、点赞数和广告视频。
- TikTok Creative Center Ad Analysis API — 按秒拆解一条热门广告的点击曲线和留存曲线。
- TikTok Creative Center Trending Hashtags API — 获取某个国家或地区的趋势话题榜,包含发帖数、播放量和热度曲线。
- TikTok Creative Center Hashtag Insights API — 深入查看单个趋势话题的热度曲线、热门地区和示例视频。
- TikTok Creative Center Top Videos API — 获取某个国家或地区的热门视频榜,包含播放量和互动率。