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

Tag labels for the current stream Send a channel login and read the classification tags attached to its stream, using the labels Twitch supplies to organize and filter a broadcast-discovery interface.
Offline channels return a clean null In the probe an offline channel gave status 'ok', a null message and data.user.stream set to null, so a missing tag collection is an expected state you can render instead of an error to catch.
Identifiers and labels kept as returned The response is meant to be stored verbatim: preserve tag identifiers and labels as supplied and do not synthesize tags that were not returned, which keeps your grouping honest.
Same input as the other stream calls Stream Details, Viewer Count and Stream Tags all take only the channel login and share the data.user envelope, so one roster loop can call all three with the same argument.
Labels that change between broadcasts Tags are a point-in-time snapshot and can change from one broadcast to the next, which makes repeated polling useful for tracking how a streamer labels their content.

Live API Demo

GET /api/project/twitch-scraper/list-stream-tags

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/list-stream-tags?key=<API_KEY>&channel=ninja'
📢
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Contact Us

Use Cases

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.

Related operations

Guides

View Subscription Plans →