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
Live API Demo
🔒 Sign in to try it live
Log in to call this API with your own API key. New accounts get 100 free credits — no card required.
Log in / Sign upNo active API key found. Create one in your Dashboard, then reload this page. Dashboard →
/api/project/twitch-scraper/search-channels API Response (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/twitch-scraper/search-channels?key=<API_KEY>&query=ninja'
Query Result
Use Cases
- Turn a brand, game or team name into a short list of candidate channels for a human to pick from
- Power a did-you-mean channel picker in an internal tool when the user only knows a display name
- Seed a watchlist from a keyword and then confirm each candidate with a channel details lookup
- Recover the real login from a display name copied out of a chat screenshot or sponsor brief
- Spot look-alike or name-squatting channels around a brand keyword, treating the roughly 15 results as a sample
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.