TikTok 公开数据 API
通过统一异步流程采集受支持的 TikTok 公开资料、直接视频元数据、顶级评论、视频搜索结果和指定标签下的视频。
可用的 TikTok API
可选择资料查询、直接视频补全、顶级评论、关键词视频搜索，或按明确 hashtag 采集视频。
可以获取哪些 TikTok 数据？
SocQ 将受支持的 TikTok 公开结果转换为标准化记录，用于达人研究、内容分析、监测和数据管道。
公开资料
按用户名获取身份、简介、账号状态，以及可见的粉丝、关注、视频和获赞计数。
公开视频
采集文案、创作者、互动快照、媒体引用、时长、标签、提及、音乐和内容状态。
顶级评论
采集公开顶级评论文本、作者信息、点赞数、回复数、提及和创作者互动状态。
视频发现
使用受支持的筛选条件搜索公开视频，或采集指定 hashtag 下的公开视频。
SocQ 与 TikTok 开发者产品对比
SocQ 专注于受支持的公开数据采集和标准化记录；需要平台授权或官方账号与内容操作时，应使用 TikTok 官方开发者产品。
| 能力 | SocQ | TikTok 开发者产品 |
|---|---|---|
| 主要用途 | 受支持的公开数据采集与标准化 | 在对应产品和审核范围内进行官方集成 |
| 鉴权 | SocQ API key | TikTok 开发者凭据和适用的授权流程 |
| 内容操作 | 不上传、编辑、删除、点赞、关注、私信或管理 TikTok 内容 | 取决于获批的官方产品和权限 |
| 私密或受限数据 | 不支持 | 受官方产品、用户授权和平台政策限制 |
| 响应格式 | 标准化 SocQ 记录 | 对应产品的原生响应 |
TikTok API 如何工作
五个接口共用异步提交、任务轮询和 cursor 分页生命周期。
1. 提交公开输入
POST 用户名、直接视频 URL、搜索关键词或明确 hashtag，并附带接口专属选项。
2. 轮询任务
使用返回的 task_id 请求 /v1/tasks/{task_id}，直到处理成功或失败。
3. 读取并分页
从 data.results.items 读取标准化记录，并在 has_more 为 true 时继续使用 next_cursor。
使用 SocQ API key 鉴权。以下示例获取公开资料；直接视频、顶级评论、搜索或标签请切换到对应接口。
curl -X POST "https://api.socq.ai/v1/tiktok/profiles" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["nasa"]}'
# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items，并在 has_more 为 true 时继续传入 next_cursor常见 TikTok API 使用场景
达人研究
为已知用户名标准化公开身份和采集时账号计数。
内容与反馈监测
采集选定视频元数据和公开顶级评论快照，用于审阅和报告。
主题发现
按关键词搜索公开视频，或采集与明确 hashtag 关联的视频。
数据管道
将标准化记录接入数据仓库、分类器、搜索索引、审阅工具和看板。
限制与公开数据政策
TikTok 公开结果是动态的，并受当前可见性、源站资格、排序、地区和可用性影响。
- 私密、已删除、受限、被过滤或其他不可访问资源可能没有记录。
- 可见计数、搜索排名、评论排序和公开可用性会在采集后变化。
- 请求的 results_limit 只是上限，不保证存在同样数量的合格公开记录。
- SocQ 不是 TikTok 官方 API，也不执行账号授权、内容管理、点赞、关注、上传或私信。
TikTok API 常见问题
SocQ 是 TikTok 官方 API 吗？
不是。SocQ 采集并标准化受支持的公开结果；官方授权和获批平台操作应使用 TikTok 开发者产品。
用户需要连接 TikTok 账号吗？
这些公开数据接口不需要客户 TikTok OAuth，请求使用 SocQ API key 鉴权。
目前提供哪些 TikTok 资源？
目前提供 Profiles、Videos、Comments、Search 和 Hashtags，每个接口都有独立输入和标准化结果契约。
如何计费？
Profiles 每条 0.6 积分，Videos、Search、Hashtags 每条 0.7 积分，Comments 每条 0.25 积分。