List Twitch Stream Tags by Channel Login
View all Twitch Channel, Clips, Videos & Stream Data endpoints →Returns the classification tags attached to the current stream of one Twitch channel, so you can group or filter broadcasts by the labels Twitch shows. Input: channel (required) is the channel login shown in the public Twitch URL, for example ninja, not a display title. Observed in a live probe for channel ninja while the channel was offline: HTTP 200 with the standard envelope {status, request_id, message, data}; status was 'ok', message was null, and data.user held id (a string), stream set to null and __typename 'User'. With a null stream there were no tags to read, and that is a documented valid result rather than an invalid channel. The populated branch was not observed in the probe, so the names of the tag identifier and label fields are not documented here; inspect a response from a live channel before mapping them, keep the returned identifiers and labels exactly as supplied and never infer tags that are not returned. Tags can change over time and do not prove the channel is still live when you display them later; use Get Stream Details for the broadcast context.
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/list-stream-tags API Response (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/twitch-scraper/list-stream-tags?key=<API_KEY>&channel=ninja'
Query Result
Use Cases
- Group tracked streamers on a broadcast-discovery page by the tags their current stream carries
- Keep a tag-change log to see how a streamer relabels broadcasts across a week
- Segment an outreach list by tag text such as language, genre or community labels before drafting messages
- Fill a dashboard tags column only while a stream exists and show a no-stream state otherwise instead of an empty chip list
- Store an empty or absent tag collection as unknown rather than untagged so later reports do not overstate what a channel lacks
Frequently asked questions
Why did the tags call return a null stream with no tags?
In the probe for channel ninja the channel was offline, so data.user.stream was null and there was no tag collection to read. An empty or absent collection is different from an invalid channel and can depend on stream or Twitch availability at request time.
Which fields hold the tag identifier and label?
The populated branch was not observed in the probe, so the exact field names are not documented here. Call the endpoint for a channel that is broadcasting, inspect data.user.stream, and treat the identifier and label you find there as the values to store unchanged.
Should an empty tag list be saved as untagged?
No. An empty or absent collection can mean the channel is offline or that no tags were available when the call ran. Save it as unknown or not available so your reports do not claim the channel has no tags.
Do the tags tell me the channel is live right now?
No. Tags can change over time and do not establish that the channel is still live when your application shows them later. Pair the call with Get Stream Details when you need the live or offline state.
Does this endpoint add the offline message that Stream Details returns?
No. In the probe the message field was null for this operation, while Get Stream Details was the only stream operation that added a message saying the channel is currently offline. Rely on the null stream, not the message, here.
What value do I send as channel?
Send the channel login from the public Twitch URL, for example ninja. If you only have a display name, resolve it with Search Channels first and reuse the login it returns.
Can I filter channels by tag with this endpoint?
No. The endpoint takes one channel login and returns the tags for that channel's stream. To filter or group by tag, call it for each channel in your own roster and apply the filter in your application.