TikTok Following List API

TikTok Following List

主要特性

• 来源账号与关注对象关联分别采集每个公开 username 的已关注个人资料，并在 extra.input_username 中保留来源账号。
• 标准化关注对象身份为每条保存记录返回稳定用户 ID、username、显示名称和规范 TikTok 主页 URL。
• 公开个人资料信息记录已关注账号公开展示的简介、头像引用和可见账号指标。
• 逐账号控制采集深度对每个 username 分别应用 results_limit，在翻取可用列表页面时按稳定身份去重保存。

参数

如何使用

提交公开来源账号，并从完成的异步任务中读取标准化的已关注个人资料记录。

1. 准备一个或多个公开 TikTok username，可以带或不带开头的 @，并为每个 username 选择 20 到 2000 之间的 results_limit。
2. 将 usernames 和 results_limit POST 到 /v1/tiktok/following-list，并保存返回的 task_id。
3. 任务处于 queued、running 或 retrying 时轮询 GET /v1/tasks/{task_id}，直到成功或失败。
4. 任务成功后读取 data.results.items；当 has_more 为 true 时，把 next_cursor 传给同一任务接口以读取下一页已保存结果。

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

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

最佳使用场景

• 兴趣网络研究： 结合来源账号与已关注对象的 ID、username 和简介，研究已知账号周边的公开兴趣网络。
• 从种子账号发现创作者： 利用显示名称、简介、头像、主页链接和可见指标，从账号公开关注对象中整理个人资料候选清单。
• 个人资料库补全： 为基于 username 的记录补充稳定 ID、规范主页 URL、公开简介、头像和可见账号指标。

使用建议

• 提交前移除 username 开头的 @ 并去重，避免同一来源账号因不同写法被重复处理。
• 按每个 username 所需的采集深度设置 results_limit；输入账号越多，去重和列表结束前的结果上限可达到 usernames 数量乘以 results_limit。
• 优先使用 id 作为个人资料主键，缺失时再使用 url，并保留 extra.input_username 以追溯来源账号。
• 结果为空或明显少于上限时，先检查账号隐私状态和关注列表可见性，再决定是否重试。
• 除非下游数据另有明确字段，否则不要把返回顺序解释为关注时间或关系强度。

相关 API