Late last year we introduced Tags, a new discovery tool that lets streamers describe their content in more detail and viewers more easily filter through categories, channels, etc. Today, we are pleased to announce that a new Tags API is now available to enable third party application developers to fully integrate Tags into their apps!
With the new Tags API, it is possible to do the following:
Fetch the list of available stream tags
A third party application developer can retrieve a paginated list of available stream tags through a GET endpoint. By default, this endpoint will return all stream tags, but it’s also possible to filter this list down to a specific set of tags.
Fetch the list of tags applied to a stream
A third party application developer can retrieve the set of all stream tags applied to a specific stream through a GET endpoint.
Replace stream tags
A third party application developer can specify a channel and a set of stream tags to replace the set of stream tags that are already applied to that channel through a PUT endpoint. This API requires user authentication, as only the creator or an editor of a channel may replace tags on that channel.
Use an updated Get Streams API
We’ve also updated the existing Get Streams GET endpoint to return the set of all stream tags applied to the specified stream.
To get started
- Check out the documentation for the new Get All Stream Tags API
- Check out the documentation for the new Get Stream Tags API
- Check out the documentation for the new Replace Stream Tags API
- Check out the documentation for the updated Get Streams API
- Let us know if you have any questions or feedback in the API developer forum!