TikTok Live Search
TikTok 直播间就是一场正在进行的直播,带有房间 ID、标题、主播、实时在线人数、累计点赞和开播时间。按关键词匹配这些直播间,就能看到此刻有谁围绕某个话题开播、各场的观众规模有多大,这也是研究直播带货、物色主播和监测品牌直播热度的起点。
TikTok Live Search API 主要特性
- 关键词进,在播直播间出query 接受一个关键词,返回搜索那一刻正在直播的直播间,每条的 status 都是 live。
- 房间 ID 和主播 ID 在同一条记录里id 是房间 ID,author.id 是主播的用户 ID,正是 TikTok Live Shopping 查询该直播间商品所需的两个值。
- 采集时刻的观众规模metrics.viewers_count 是直播间当前的人数,metrics.likes_count 是累计点赞,并附带 collected_at 时间戳。
- 标题、开播时间、封面和直播页每条记录包含直播标题、published_at 中的开播时间、media 中的封面图、url 中指向主播直播页的链接,以及主播的账号名、显示名称和头像。
TikTok Live Search API 参数
| 参数 | 必填 | 描述 |
|---|---|---|
query | 必填 | 用于查找直播间的关键词。 |
results_limit | 可选 | 返回的直播间数量,取值 1 到 200,默认 20。 |
如何使用 TikTok Live Search API
用关键词搜索,读取此刻正在直播的直播间。
- 向 /v1/tiktok/search-live 发送 {"query": "deals", "results_limit": 20}。
- 轮询 GET /v1/tasks/{task_id},直到 status 变成 succeeded。
- 从 results.items 读取直播间;has_more 为 true 时,带上 results.next_cursor 继续读取。
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 是房间 ID;author.id 是主播 ID,可用于 TikTok Live Shopping。TikTok Live Search API 最佳使用场景
- 摸排竞品的带货直播间: 用卖家在直播里常说的商品词搜索,例如 deals,再把每个直播间的 id 和 author.id 交给 TikTok Live Shopping,看购物袋里在卖什么。
- 统计某个关键词下的直播热度: 按固定时间重复同一个 query,记录在播直播间的数量和各自的 viewers_count,看一个话题或品牌什么时候最能吸引直播观众。
- 给合作主播建候选名单: 收集围绕你的话题正在开播的主播,按 viewers_count 和 likes_count 排序,再决定联系谁。
TikTok Live Search API 使用建议
- 同一个领域多换几种说法搜索,并按 id 合并结果:每个关键词返回的直播间不同,同一场直播也可能同时命中多个关键词。
- id 和 author.id 分开保存:id 对应一场直播,author.id 对应主播,要跨天跟踪某位主播请用 author.id。
- 想长期盯某一个直播间的在线人数,不要反复搜索,改用 TikTok Live Room Info,传入该直播间的 room_id 和 user_id。
相关 API
除了 TikTok Live Search API,需要其他类型的 TikTok 公开数据时,可以使用以下 API。
- TikTok Profiles API — 按 username 获取公开主页身份、简介、账号标记和受众计数。
- TikTok Hashtags API — 按指定标签采集公开视频、创作者、媒体、声音和互动指标。
- TikTok Search API — 按关键词搜索公开视频,并支持排序和发布时间筛选。
- TikTok Live Room Info API — 使用配对的直播间 ID 和主播 ID 查询一个已知直播间,返回状态、主播信息、封面和受众计数。
- TikTok Search Users API — 按关键词搜索 TikTok 公开账号。
- TikTok Live Shopping API — 列出直播间购物袋里的商品,包含当前售价和销量。
- TikTok Comments API
- TikTok Videos API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok User Videos API
- TikTok Trending Feed API
- TikTok Video Transcript API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Photo Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API