按名称或关键词搜索 Twitch 频道
查看 Twitch 频道、剪辑、视频与直播数据 API 的全部接口 →按文本搜索公开可发现的 Twitch 频道,返回一份简短的候选列表,帮助你选出想要的频道。输入参数:query(必填)是频道名称或任意搜索文本,例如 ninja。该接口不提供 cursor 或页码参数,响应中也没有游标。以查询词 ninja 的一次实测为例:响应使用统一的外层结构 {status, request_id, message, data},status 为 'ok',message 为 null;data.channels 含 15 条记录,每条形如 {trackingID, item}。每个 item 包含 id、login、displayName、profileImageURL、description(字符串,15 条中有 2 条为 null)、followers.totalCount、roles(isPartner、isParticipatingDJ)、broadcastSettings(id、title)、lastBroadcast(id、startedAt)、channel(id、schedule)、latestVideo.edges[].node(id、title、lengthSeconds 及预览缩略图字段)和 topClip.edges[].node(id、slug、title、durationSeconds、thumbnailURL);self、watchParty 和 channel.schedule 为 null。在这次搜索实测中,item.stream 对一个离线频道为 null,其余 14 个频道为对象,包含 type、viewersCount、game、freeformTags 等字段;这些直播字段只在这次搜索样本中见到,并未在其他接口上验证。请保留返回的 login 和各类 id:展示名可能与频道及直播查询所需的登录名不同。结果在不同调用之间可能变化,也不是完整的频道目录。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/twitch-scraper/search-channels API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/twitch-scraper/search-channels?key=<API_KEY>&query=ninja'
查询结果
使用场景
- 把品牌、游戏或战队名称转成一份简短的候选频道清单,交给人工挑选
- 当用户只知道展示名时,在内部工具里提供「你要找的是不是这个频道」的选择器
- 先用关键词建立关注名单,再逐个通过频道详情查询来确认候选频道
- 从聊天截图或赞助需求文档里复制的展示名,反查出真实的登录名
- 围绕品牌关键词排查名称相似或恶意抢注的频道,并把约 15 条结果视为样本而非全部
常见问题
一次搜索会返回多少个频道,能翻页获取更多吗?
对查询词 ninja 的实测在 data.channels 中返回了 15 条。该接口没有 cursor 或页码参数,响应里也没有游标,所以无法翻页;想看到其他频道,请调整查询文本。
应该按登录名还是按展示名搜索?
query 接受频道名称或搜索文本。展示名可能与登录名不同,所以请对比返回的 login、displayName、description 和 followers.totalCount 来选出目标频道,然后用登录名去做频道和直播查询。
搜索结果是 Twitch 频道的完整目录吗?
不是。结果只覆盖公开可发现的频道,不同调用之间可能变化,应视为样本而不是完整列表。在依赖某个候选频道之前,请先用「获取频道详情」确认。
搜索能告诉我哪些频道正在直播吗?
可以给出提示。实测中 15 条结果里有 14 条的 item.stream 是对象,另一个离线频道为 null;直播对象包含 type、viewersCount 和 game 等字段。这些字段只在搜索样本中观察到,如需专门检查直播状态,请使用直播相关接口。
为什么有些结果的 description 为 null?
描述是可选的资料文字。实测 15 条中有 13 条是字符串描述,2 条为 null,所以在展示或建立索引之前请先处理 null。
每条搜索结果里的 trackingID 是什么?
每条记录在 item 对象旁边有一个 trackingID 字符串。请把它视为不透明的值,用 item.id 和 item.login 来识别频道。
搜索频道需要 Twitch 应用或令牌吗?
不需要。你只需要本服务的 API 密钥和一个查询字符串,无需注册 Twitch 应用,也不用刷新令牌。