TikTok Profiles
TikTok Profiles 是创作者或账号的公开主页，包含身份、简介、头像、认证与隐私状态，以及可见的粉丝、关注、视频和获赞总数。这些主页信号可用于达人发现、受众比较、合作研究和目录补全。
主要特性
- 批量 username 查询在一次请求中查询一个或多个公开创作者 username。
- 标准化 username 输入统一 nasa 与 @nasa 两种写法，减少名单清洗工作。
- 稳定的主页身份用账号 ID、用户名、显示名称和资料页 URL 建立身份索引。
- 主页与受众字段在一条记录中返回简介、头像、认证与隐私状态，以及粉丝数、关注数、视频数和总获赞数。
- 可追溯的主页快照通过原始输入和 collected_at 追踪每次账号补全与周期快照。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
usernames | 必填 | 必填的 TikTok 公开用户名列表，可以带或不带开头的 @。 |
如何使用
从达人用户名清单开始，批量生成可入库的创作者档案。
- 整理达人清单，统一 nasa 和 @nasa 等用户名写法并去重。
- 把 usernames 数组 POST 到 /v1/tiktok/profiles，并保存返回的 task_id。
- 轮询 /v1/tasks/{task_id}，queued 和 running 都是正常中间状态。
- 任务成功后读取 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
需要其他类型的 TikTok 公开数据时，可以使用以下 API。
- TikTok Hashtags API — 按指定标签采集公开视频、创作者、媒体、声音和互动指标。
- TikTok Comments API — 采集公开顶级评论、作者、互动、提及和创作者互动标记。
- TikTok Videos API — 从视频 URL 获取创作者、文案、媒体、音乐、标签、提及和互动信息。
- TikTok Search API — 按关键词搜索公开视频，并支持排序和发布时间筛选。
- TikTok Comment Replies API — 使用 TikTok 视频 URL 和 comment_id 采集一条已知评论下的公开回复，返回作者、互动、时间和父评论上下文。
- TikTok Followers List API — 采集公开粉丝列表中可见的标准化资料，并保留来源上下文和支持的指标。
- TikTok Following List API — 采集 TikTok 账号公开可见的关注对象，返回标准化身份、简介、可见指标和来源账号信息。
- TikTok User Videos API — 按 username 采集公开个人资料视频，返回文案、创作者、媒体、时间、互动和来源账号上下文。
- TikTok Live Room Info API — 使用配对的直播间 ID 和主播 ID 查询一个已知直播间，返回状态、主播信息、封面和受众计数。
- TikTok Trending Feed API — 按 region 采集当前公开视频动态，返回创作者、文案、封面、时间和可见互动指标。
- TikTok Video Transcript API — 从公开视频 URL 提取可用字幕文本、语言、格式和来源上下文。