Twitch
Read Twitch users, channels, live streams, videos, and followed streams
Connect Twitch when a project needs current channel, stream, or video data. A shared connection uses one Twitch account for a project. A published app can let each signed-in app user authorize their own account.
This release is read-only. It does not send chat messages, moderate channels, start broadcasts, or change channel settings.
Before you connect
A Swarmz administrator must register an application in the Twitch developer console, add the callback URL shown on the Swarmz admin integration card, and enable the connector. Each user then completes Twitch OAuth. Swarmz sends both the user's access token and the configured application client ID to the fixed Twitch API origin.
The followed-stream operation requests user:read:follows. Other released reads use Twitch's public Helix resources with the authorized application and user context. Twitch requires applications to validate OAuth tokens; revoked or expired access returns the connection to a reconnect state.
Available operations
| Operation | What it does | Limit per minute |
|---|---|---|
get_users | Gets users by ID or login | 30 |
search_channels | Searches channels and can restrict results to live channels | 30 |
get_channels | Gets channel information for broadcaster IDs | 30 |
list_streams | Lists live streams using user, game, language, and type filters | 30 |
list_videos | Lists videos by video, user, or game with period and sort filters | 30 |
list_followed_streams | Lists live streams followed by the connected user | 30 |
Connect Twitch
For a shared dashboard, ask: “Use our Twitch connection to show whether these channels are live and display their latest videos.” For a personal app experience, ask: “Let each signed-in user connect Twitch and show live channels they follow.”
Select Connect new, approve Twitch access, then link the connection to the project. Use an app-user connection when the result depends on each viewer's followed channels.
Verify Twitch
- Get a known user by login and confirm the returned broadcaster ID.
- Search for the channel and compare its live state with Twitch.
- List its videos and confirm the order and titles.
- List followed live streams for the connected user's ID.
- Revoke the application in Twitch and confirm the next request asks for reconnection.
If public channel reads work but followed streams fail, reconnect and approve follow access. If every request fails, confirm the admin application still exists, its client ID matches the stored configuration, and its callback URL is exact.