spike-faye-lei Twitch
Overview
Live streaming platform. All public data served through a GraphQL API at gql.twitch.tv/gql using persisted queries (sha256 hashes) or raw GQL queries. No auth needed for public reads.
Workflows
Find a streamer and check if they're live
searchChannels(query)→edges[].item.login(channelLogin),displayName,followers.totalCountgetStream(channelLogin)→stream(null = offline),stream.game.name,lastBroadcast.title
Browse a channel profile
searchChannels(query)→edges[].item.logingetChannel(channelLogin)→description,followers.totalCount,socialMedias[],roles.isPartner
Discover popular games
getTopGames(limit, sort)→edges[].node.displayName,viewersCount,broadcastersCount,tags[]
Browse top live streams
getTopStreams(limit)→edges[].node.viewersCount,broadcaster.login,broadcaster.displayName,game.name
Get clips for a channel
searchChannels(query)→edges[].item.logingetClips(login, criteria)→edges[].node.title,viewCount,durationSeconds,game.name
Get past broadcasts for a channel
searchChannels(query)→edges[].item.login→ use aschannelOwnerLogingetVideos(channelOwnerLogin)→edges[].node.title,viewCount,lengthSeconds,broadcastType
Operations
| Operation | Intent | Key Input | Key Output | Notes |
|---|---|---|---|---|
| searchChannels | find channels by keyword | query | login, displayName, followers.totalCount, broadcastSettings.title | entry point; cursor pagination |
| getChannel | channel profile | channelLogin ← searchChannels.login | displayName, followers.totalCount, roles.isPartner, socialMedias[], schedule.nextSegment | |
| getStream | live stream status | channelLogin ← searchChannels.login | stream (null=offline), stream.game.name, lastBroadcast.title | |
| getTopGames | top categories/games | limit, sort | displayName, viewersCount, broadcastersCount, tags | entry point |
| getTopStreams | top live streams | limit | viewersCount, broadcaster.login, broadcaster.displayName, game.name | entry point; raw GQL query |
| getClips | channel clips | login ← searchChannels.login | title, viewCount, durationSeconds, game.name | time filter: LAST_DAY/WEEK/MONTH/ALL_TIME |
| getVideos | channel VODs | channelOwnerLogin ← searchChannels.login | title, viewCount, lengthSeconds, broadcastType, game.name | sort: TIME or VIEWS |
Quick Start
# Search for channels
openweb twitch exec searchChannels '{"query":"valorant"}'
# Get channel profile
openweb twitch exec getChannel '{"channelLogin":"shroud"}'
# Check if a channel is live
openweb twitch exec getStream '{"channelLogin":"shroud"}'
# Browse top games/categories
openweb twitch exec getTopGames '{"limit":10}'
# Browse top live streams
openweb twitch exec getTopStreams '{"limit":10}'
# Get clips for a channel
openweb twitch exec getClips '{"login":"shroud"}'
# Get past broadcasts for a channel
openweb twitch exec getVideos '{"channelOwnerLogin":"shroud"}'