Search Twitch Channels by Name or Keyword

View all Twitch Channel, Clips, Videos & Stream Data endpoints →

Searches publicly discoverable Twitch channels by text and returns a short list of candidates so you can pick the intended channel. Input: query (required) is a channel name or free search text, for example ninja. No cursor or page parameter is exposed, and the response carries no cursor. Observed in a live probe for query ninja: the response is the standard envelope {status, request_id, message, data} with status 'ok' and a null message, and data.channels held 15 entries, each {trackingID, item}. Each item carried id, login, displayName, profileImageURL, description (a string, or null on 2 of the 15), followers.totalCount, roles (isPartner, isParticipatingDJ), broadcastSettings (id, title), lastBroadcast (id, startedAt), channel (id, schedule), latestVideo.edges[].node (id, title, lengthSeconds, preview thumbnail fields) and topClip.edges[].node (id, slug, title, durationSeconds, thumbnailURL); self, watchParty and channel.schedule were null. item.stream was null for one offline channel and an object for the other 14 in this search probe, with fields such as type, viewersCount, game and freeformTags; those live-stream fields were seen only in this search sample and are not verified for other operations. Keep the returned login and source ids: a display name may differ from the login that channel and stream lookups require. Results can change between calls and are not an exhaustive directory.

API Features

Keyword and name search Send a channel name or free text in the query parameter and get back a ranked list of matching public Twitch channels, about 15 per call in the probe.
Login recovery for follow-up calls Every hit includes item.login and item.id, so you can turn a display name into the exact login that Get Channel Details, clips and stream lookups require.
Disambiguation fields per hit displayName, description, followers.totalCount, profileImageURL and roles.isPartner appear on each result, giving enough context to tell the intended channel from look-alikes.
Latest video and top clip previews Each hit embeds a latestVideo edge and a topClip edge with ids, titles, durations and thumbnails, so a picker UI can show recent content without extra requests.
Live hints inside results item.stream is null for offline channels and an object for live ones in the probe, so a result list can be annotated with a current-game and viewer hint before any detail lookup.

Live API Demo

GET /api/project/twitch-scraper/search-channels

Request cost is temporarily unavailable. No price is assumed.

View pricing

API Response (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/twitch-scraper/search-channels?key=<API_KEY>&query=ninja'
📢
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Contact Us

Use Cases

Frequently asked questions

How many channels does a search return and can I page through more?

The probe for query ninja returned 15 entries in data.channels. This operation exposes no cursor or page parameter and the response has no cursor, so you cannot page; vary the query text to surface other channels.

Should I search by login or by display name?

The query accepts a channel name or search text. A display name can differ from the login, so compare the returned login, displayName, description and followers.totalCount to choose the intended channel, then use the login for channel and stream lookups.

Is the search result an exhaustive directory of Twitch channels?

No. Results cover publicly discoverable channels, can change between calls, and should be treated as a sample rather than a complete list. Confirm a candidate with Get Channel Details before relying on it.

Does search tell me which channels are live?

It can hint at it. In the probe item.stream was an object for 14 of 15 results and null for one offline channel; the live objects included fields such as type, viewersCount and game. These were observed only in the search sample, so use the stream operations for dedicated live-status checks.

Why is description null for some results?

Descriptions are optional profile text. In the probe 13 of 15 items had a string description and 2 had null, so handle null before displaying or indexing it.

What is trackingID on each search entry?

Each entry has a trackingID string next to its item object. Treat it as opaque and identify channels by item.id and item.login instead.

Do I need a Twitch app or token to search channels?

No. You only need your API key for this service and a query string; there is no Twitch application to register and no token to refresh.

Related operations

Guides

View Subscription Plans →