SocQ 早已支持公开的 TikTok 主页、视频、评论、搜索和话题标签,TikTok 采集指南 介绍了这些接口。2026-11-17,又有 14 个 TikTok 接口上线到 TikTok 平台页。它们回答了基础接口回答不了的问题:达人的粉丝在哪些国家、视频播放量是否真实、今天大家在搜什么、某个直播间此刻在卖什么。
本文按用途对新接口分组,每个接口给出一条请求示例,并列出价格和适用场景。
快速回答: 每个接口都是向
https://api.socq.ai/v1/tiktok/<endpoint>发送带 JSON 请求体的POST。调用返回task_id;轮询GET /v1/tasks/{task_id}直到status为succeeded,再读取data.results.items。
新 TikTok 接口一览
1 SocQ credit = $0.005。按结果计费的接口没有基础费用,结果为空时不收费。
| 接口 | 返回内容 | 价格 |
|---|---|---|
| TikTok 粉丝地区分布 API | 粉丝样本中的国家,含占比和样本人数 | 每次调用 20 credits($0.10) |
| TikTok 刷量检测 API | 刷量分数、估算的虚假播放量及占比、流量层级、主要原因 | 每次调用 5 credits($0.025) |
| TikTok 相似账号 API | TikTok 推荐的相似账号,含简介和各项计数 | 每个账号 0.5 credits($0.0025) |
| TikTok 转发视频 API | 账号转发的视频,含原作者和数据 | 每条视频 0.5 credits($0.0025) |
| TikTok 合集列表 API | 公开合集,含名称、封面和视频数 | 每个合集 0.5 credits($0.0025) |
| TikTok 热门搜索 API | 今天约 100 个热门搜索,按排名 | 每次调用 0.5 credits($0.0025) |
| TikTok 创作者搜索洞察 API | 20 个热门搜索,含热度分和七点趋势 | 每次调用 1 credit($0.005) |
| TikTok 话题播放量 API | 最多 20 个话题标签的视频总数和播放总量 | 每个话题 0.5 credits($0.0025) |
| TikTok 评论关键词 API | 排序后的评论关键词及对应评论 | 每次调用 1 credit($0.005) |
| TikTok 原声搜索 API | 原声,含艺人、时长、试听和使用量 | 每个原声 0.6 credits($0.003) |
| TikTok 图文搜索 API | 图文轮播帖,含全部图片和互动数据 | 每条帖子 0.6 credits($0.003) |
| TikTok 直播搜索 API | 正在直播的直播间,含主播、观看人数和点赞 | 每个直播间 0.6 credits($0.003) |
| TikTok 直播排行榜 API | 直播日榜最多 99 位主播,含按礼物计算的分数 | 每次调用 0.5 credits($0.0025) |
| TikTok 直播带货商品 API | 直播间购物袋中的商品,含价格和销量 | 每件商品 0.1 credits($0.0005) |
认证与异步任务流程
所有请求都用 API key 认证。提交、查询任务状态和读取结果使用同一个请求头:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
每次采集都作为后台任务运行:
submit -> task_id -> queued -> running -> succeeded
\-> failed
提交请求会立即返回 data.task_id 和 data.status。用这个 ID 轮询任务:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
当 status 为 succeeded 时,响应包含 result_count、credits_amount,以及 data.results.items 中第一页标准化记录。limit 默认 50,最大 500。如果 results.has_more 为 true,把 results.next_cursor 作为 cursor 传入即可读取下一页。失败的任务带有 error_message。
下面每个请求体都可以加可选的 callback_url。任务结束后,SocQ 会发送一次带任务摘要的 POST;记录仍从任务接口读取。客户端超时不会取消任务,请用同一个任务 ID 继续读取,不要重新提交。402 表示账户余额不足,429 表示 key 触发了频率或额度限制。
付费合作前先核查达人
这五个接口帮你判断一个达人值不值得合作。
粉丝地区分布 列出粉丝样本中的每个国家,含占比和背后的样本人数,从大到小排列。预订合作前用它确认达人的触达落在你销售的市场。username 带不带 @ 都可以。(文档)
curl -X POST "https://api.socq.ai/v1/tiktok/user-audience" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username": "khaby.lame"}'
刷量检测 接收视频或图文帖 URL,返回 fake_score、is_suspicious、confidence_level、estimated_fake_views、fake_view_percentage、estimated_organic_views、traffic_tier 和 main_reason。可选的 category(默认 general,也可选 entertainment、education、product、verified_large)用于选择互动基准。适合检查商单视频,以及即将按曝光付费的达人。(文档)
curl -X POST "https://api.socq.ai/v1/tiktok/fake-views" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://www.tiktok.com/@tiktok/video/7460937381265411370"}'
相似账号 返回 TikTok 自己推荐的与某用户名相似的账号,按 TikTok 的顺序排列,含简介、粉丝数、视频数和认证状态。某个达人效果好时,用它围绕这个达人扩大候选名单。results_limit 默认 30(1 到 300)。(文档)
curl -X POST "https://api.socq.ai/v1/tiktok/similar-users" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username": "khaby.lame", "results_limit": 30}'
转发视频 展示一个账号在自己的作品之外还在推什么:每条转发视频含原作者、文案、播放、点赞、话题标签和视频文件,按时间倒序。results_limit 默认 20(1 到 500)。(文档)
curl -X POST "https://api.socq.ai/v1/tiktok/user-reposts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username": "mrbeast", "results_limit": 20}'
合集列表 列出达人的公开合集,含名称、封面和 item_count,能看出他反复做的系列和形式。results_limit 默认 20(1 到 100)。(文档)
curl -X POST "https://api.socq.ai/v1/tiktok/user-playlists" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username": "zachking"}'
完整核查一个达人,包括粉丝地区分布、对最近三条视频做刷量检测和 30 个相似账号,费用为 20 + 15 + 15 = 50 credits($0.25)。
了解大家在搜什么、聊什么
热门搜索 不需要输入,按 TikTok 的顺序返回今天约 100 个热门搜索,每个都带搜索链接。列表每天刷新,适合作为每天早上的选题来源。(文档)
curl -X POST "https://api.socq.ai/v1/tiktok/trending-keywords" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'
创作者搜索洞察 返回 20 个热门搜索,每个含 0 到 100 的热度分、七点趋势、相关视频数、类目和标签。所有字段都是可选的:language(默认 en,另有 ar、de、es、fr、id、ja、ko、pt、th、tr、vi)、category(fashion、food、gaming、science、sports、tourism)和 filter_by。把 filter_by 设为 content_gap,可以找到有需求但视频还少的搜索。(文档)
curl -X POST "https://api.socq.ai/v1/tiktok/search-insights" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"language": "en", "category": "food", "filter_by": "content_gap"}'
话题播放量 一次请求比较最多 20 个话题标签的视频总数和播放总量。不存在的标签会被跳过,不计费。(文档)
curl -X POST "https://api.socq.ai/v1/tiktok/hashtag-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"hashtags": ["cooking", "booktok"]}'
评论关键词 替你读完热闹的评论区:返回出现最多的关键词,按排名排列,每个关键词附带提到它的评论及其点赞数。(文档)
curl -X POST "https://api.socq.ai/v1/tiktok/comment-keywords" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://www.tiktok.com/@tiktok/video/7460937381265411370"}'
TikTok 在某个搜索词下显示的搜索结果,请参见 TikTok Top Search 指南。
搜索原声和图文帖
原声搜索 按歌名、艺人或氛围搜索原声库,返回原声 ID、艺人、封面、时长、可播放的试听和 metrics.videos_count。sort_by 可选 relevance(默认)、most_used 或 latest;region 默认 US。拿到的 ID 可以用于 TikTok 原声视频,也可以对照 TikTok 热门歌曲榜单指南 中的榜单。results_limit 默认 20(1 到 500)。(文档)
curl -X POST "https://api.socq.ai/v1/tiktok/search-music" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "lofi", "results_limit": 20}'
图文搜索 只返回图文轮播帖,含轮播中的全部图片,以及文案、作者、话题标签、播放、点赞、评论和分享。results_limit 默认 20(1 到 500)。(文档)
curl -X POST "https://api.socq.ai/v1/tiktok/search-photos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "outfit ideas", "results_limit": 20}'
关注 TikTok 直播和直播带货
直播搜索 查找发出请求时正在直播的直播间,含标题、主播、当前观看人数、点赞和开播时间。results_limit 默认 20(1 到 200)。(文档)
curl -X POST "https://api.socq.ai/v1/tiktok/search-live" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "deals", "results_limit": 20}'
直播带货商品 列出直播间购物袋中的商品,含标题、当前价格、销量、卖家和图片。直播搜索结果的 id 和 author.id 就是它需要的 room_id 和 user_id,所以要在直播还在进行时调用。results_limit 默认 100(1 到 500),没有商品的直播间不计费。(文档)
curl -X POST "https://api.socq.ai/v1/tiktok/live-products" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"room_id": "7704767945901132575", "user_id": "7153432386608251946", "results_limit": 100}'
直播排行榜 不需要输入,返回当前直播日榜最多 99 位主播,含排名、按礼物计算的分数、用户名和粉丝数。(文档)
curl -X POST "https://api.socq.ai/v1/tiktok/live-ranking" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'
如果要检查指定账号是否在直播,请使用 TikTok 直播状态指南 中的接口。
相关 TikTok 指南
TikTok 创意中心的广告和达人报价见 TikTok 创意中心 API 指南,新的 TikTok Shop 接口见 TikTok Shop 选品 API 指南。想把 SocQ 与其他服务商对比,请阅读 7 个最佳 TikTok 抓取 API 和 TikTok API 替代方案。
常见问题
账号没有转发或合集时会收费吗?
不会。按结果计费的接口没有基础费用,文档说明空结果不收费。
刷量检测如何判断播放是否虚假?
它把视频的互动与你在 category 中选择的内容类型基准对比,返回分数、估算的虚假播放量及占比、流量层级和主要原因。请把它当作需要复核的估算,而不是定论。
直播带货商品需要的 room_id 和 user_id 从哪里来?
来自 TikTok 直播搜索:结果的 id 就是 room_id,author.id 就是 user_id。直播必须仍在进行。
热门搜索和创作者搜索洞察有什么区别?
热门搜索是 TikTok 今天约 100 个搜索的排名列表,每次 0.5 credits。创作者搜索洞察返回 20 个搜索,含热度分和七点趋势,可按语言、类目和内容缺口筛选,每次 1 credit。