Twitch Channel API - followers, live status & stats
Pricing
$1.00 / 1,000 channels
Twitch Channel API - followers, live status & stats
Half the channel numbers scraped off Twitch are stale or missing: a channel that went dark still looks live and last-stream dates vanish. This actor asks Twitch's own public API for followers, live status, viewers and last broadcast, one row per channel. An unknown login costs nothing.
Pricing
$1.00 / 1,000 channels
Rating
0.0
(0)
Developer
Stas K
Maintained by CommunityActor stats
1
Bookmarked
2
Total users
1
Monthly active users
5 days ago
Last modified
Categories
Features
Share
Twitch Channel API
One row per public Twitch channel: who it is, how many followers it has, whether it is live right now, how many people are watching and when it last went on air.
The source is Twitch's own public web API, the same one the site calls. No login, no token, no scraping of the directory pages.
What you get
Send a login (shroud), an @handle or a full channel link (https://www.twitch.tv/pokimane),
one per line. Every channel the source really answers becomes one row:
| field | meaning |
|---|---|
login | the channel login the source confirmed (lower case) |
displayName | the name Twitch shows |
id | the numeric channel id |
url | https://www.twitch.tv/<login> |
followers | follower count as a number |
isLive | true when the channel is streaming right now |
viewers | current viewers, or null when the channel is offline |
streamStartedAt | when the current stream started, ISO 8601 in UTC, or null |
lastBroadcastAt | when the channel last went on air, ISO 8601 in UTC |
createdAt | when the channel was created, ISO 8601 in UTC |
description | the channel description, as published |
actorInput | the line you sent, kept so a row can be traced back to your input |
actorIndex | the position of that line in your list |
Twenty channels travel in one request, because the source answers batches. That is why a run of two hundred channels takes about five seconds and not five minutes.
What costs money
One delivered channel is one paid event, price $0.001.
Free, with a reason in the row and no channel data:
NOT_FOUND: the source does not know that login.INVALID_INPUT: the line is not a channel (an empty line, a directory page such astwitch.tv/directory, a video page).DUPLICATE: the same channel arrived more than once (a login, an@handleand a link to the same channel are one channel, and only the first one is paid).NOT_CHECKED_CAP: the line was cut bymaxChannels, by the time budget or by the spending limit before any request.NOT_CHECKED_ERROR: the source could not be read; this is a state of the source, not a verdict about your channel, and nothing is charged.
Input
{"channels": ["shroud", "@pokimane", "https://www.twitch.tv/xqc"],"maxChannels": 25}
maxChannels defaults to 25 and can go up to 500. A value the source does not publish is
null, never invented: an offline channel shows viewers: null and not 0, because zero
viewers and no broadcast are different facts.
What this actor does not do
- It does not read chat, clips, videos or the follower list of a channel.
- It does not page through a directory: you name the channels, it reads them.
- It does not tell you why a channel is missing from Twitch: a login the source does not know
is
NOT_FOUNDand nothing more. - It does not guess: a login that is close to a real one is
NOT_FOUNDwith the exact login you sent, so you can fix the line instead of paying for someone else's channel.
Rate limits
The source answers twenty channels per request in well under a second. A batch that comes back
with HTTP 429 is retried once after the pause the source asks for; the counter throttled is
not used here because a retry never costs a channel. Two hundred channels in a row were read
without a single 429 in our measurement (16.11.2026).
Data source
Public Twitch GQL endpoint, https://gql.twitch.tv/gql, with the public web client id. This
actor is not affiliated with or endorsed by Twitch.