Get Twitch Channel Profile and Followers by Login
View all Twitch Channel, Clips, Videos & Stream Data endpoints →Returns public profile metadata for one Twitch channel, looked up by its login. Use it to identify a channel before fetching clips, videos or stream information. 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: the response is the standard envelope {status, request_id, message, data} with status 'ok' and a null message, and data.user holds id, login, displayName, primaryColorHex, profileImageURL and bannerImageURL; followers.totalCount (an integer); roles with isPartner and isParticipatingDJ booleans; and a channel object with its own id, self (isAuthorized, restrictionType), trailer (video) and home.preferences.heroPreset. The stream field was null in the probe because the channel was offline at that moment; the populated live-stream branch was not observed, so its field names are not documented here and live status should be read from the stream operations. Identifiers should be kept as strings and optional profile fields kept as returned: a missing field does not prove the channel was deleted, and a channel that exists is not necessarily broadcasting.
API Features
Live API Demo
🔒 Sign in to try it live
Log in to call this API with your own API key. New accounts get 100 free credits — no card required.
Log in / Sign upNo active API key found. Create one in your Dashboard, then reload this page. Dashboard →
/api/project/twitch-scraper/get-channel-details API Response (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/twitch-scraper/get-channel-details?key=<API_KEY>&channel=ninja'
Query Result
Use Cases
- Resolve a typed channel login to a Twitch user id and store the id so a later rename does not orphan the record
- Pull followers.totalCount into a creator rate-card sheet before an outreach email goes out
- Verify a sponsorship candidate's channel exists and review its profile image and roles block before signing a deal
- Run a daily follower-count snapshot job for a watchlist of 50 streamers to chart growth over time
- Enrich a Discord bot's /streamer command with avatar, display name and follower total
Frequently asked questions
What value should I send as channel for a channel lookup?
Send the channel login as it appears in the public Twitch URL, for example ninja. A display title such as a capitalized name with spaces is not a login. If you only know a name, call Search Channels first and reuse the login it returns.
Does this endpoint tell me whether the streamer is live right now?
Not reliably. In the probe data.user.stream was null because the channel was offline, and the populated live-stream branch was not observed, so no live-stream field names are documented for this operation. Use the stream operations for current broadcast information; a channel existing does not imply it is live.
What does followers.totalCount represent?
It is the channel's follower total as an integer at the moment of the request. It is a point-in-time value, so store it with a timestamp if you want to chart growth.
Should I treat the id as a number or a string?
Keep it as a string. The probe returned data.user.id as a string, and the source guidance is to preserve identifiers as strings rather than convert them.
What if some profile fields are missing or empty?
Keep optional profile fields exactly as returned. Missing metadata does not establish that the channel was deleted. The probe only covered an existing channel, so handle a non-ok status or a missing data.user defensively for unknown logins.
Which fields in the response tell me about partner status?
data.user.roles contains isPartner and isParticipatingDJ booleans. Both were present in the probe for channel ninja; other role flags were not observed.
Do I need Twitch credentials to use this channel info API?
No. You send only your API key for this service and the channel login. There is no Twitch application to register and no client-credentials token to mint or refresh.