TikTok Profiles API

TikTok Profiles

主要特性

• 批量 username 查询在一次请求中查询一个或多个公开创作者 username。
• 标准化 username 输入统一 nasa 与 @nasa 两种写法，减少名单清洗工作。
• 稳定的主页身份用账号 ID、用户名、显示名称和资料页 URL 建立身份索引。
• 主页与受众字段在一条记录中返回简介、头像、认证与隐私状态，以及粉丝数、关注数、视频数和总获赞数。
• 可追溯的主页快照通过原始输入和 collected_at 追踪每次账号补全与周期快照。

参数

如何使用

从达人用户名清单开始，批量生成可入库的创作者档案。

1. 整理达人清单，统一 nasa 和 @nasa 等用户名写法并去重。
2. 把 usernames 数组 POST 到 /v1/tiktok/profiles，并保存返回的 task_id。
3. 轮询 /v1/tasks/{task_id}，queued 和 running 都是正常中间状态。
4. 任务成功后读取 data.results.items；如果 has_more 为 true，则继续传入 next_cursor。

curl -X POST "https://api.socq.ai/v1/tiktok/profiles" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["nasa","@tiktok"]}'

# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items，并在 has_more 为 true 时继续传入 next_cursor

最佳使用场景

• 达人库建档： 把用户名清单补全为带账号 ID、头像、简介、认证状态和规模指标的创作者卡片。
• 商务合作准备： 在邀约前集中查看创作者身份、内容规模与受众规模，完善候选人背景资料。
• 账号成长看板： 定期保存同一批创作者的粉丝、视频和总获赞快照，观察成长轨迹。
• 跨表身份关联： 以账号 ID 连接创作者、视频和评论数据，减少用户名格式带来的匹配成本。

使用建议

• 把 id 设为创作者主键，把 username 留作搜索词和前台展示字段。
• 保留原始输入，方便把 API 结果准确回填到最初的达人名单。
• 为成长分析固定采集频率，并用 collected_at 标记每次指标快照。
• 先按去掉 @ 后的用户名去重，避免同一账号重复进入批量任务。
• 在创作者卡片中组合 avatar、display_name、biography 和 profile_url，提升商务检索效率。
• 用账号 id 连接该创作者相关的视频和评论记录，形成完整的内容画像。

相关 API