按名称或关键词搜索 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 功能

关键词与名称搜索 在 query 参数里传入频道名称或任意文本,即可得到匹配的 Twitch 公开频道列表,实测每次调用约返回 15 条。
为后续调用找回登录名 每条结果都包含 item.login 和 item.id,可以把展示名换成「获取频道详情」、片段和直播查询所需的准确登录名。
每条结果的辨识字段 每个结果都带有 displayName、description、followers.totalCount、profileImageURL 和 roles.isPartner,足以帮你把目标频道和名称相近的频道区分开。
最新视频与热门片段预览 每条结果内嵌 latestVideo 和 topClip,包含 id、标题、时长和缩略图,选择器界面无需额外请求就能展示近期内容。
结果中的直播提示 实测中离线频道的 item.stream 为 null,直播中的频道则为对象,因此在查询详情之前,就能给结果列表标注当前游戏和观看人数提示。

在线 API 演示

GET /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'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

一次搜索会返回多少个频道,能翻页获取更多吗?

对查询词 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 应用,也不用刷新令牌。

相关接口

相关指南

查看订阅方案 →