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

Login to user id lookup Resolve a typed channel login to the Twitch user id returned in data.user.id, so you can store a durable key instead of a name that may change.
Follower total in one call followers.totalCount returns the channel's follower count as an integer at request time, ready for rate cards, growth charts and watchlist sheets.
Profile and banner imagery profileImageURL, bannerImageURL and primaryColorHex are included, so a dashboard or bot can render an avatar, banner and brand color without a second request.
Partner and DJ role flags The roles object exposes isPartner and isParticipatingDJ booleans, which helps screen sponsorship candidates and segment channels by status.
Channel page settings The nested channel object returns the channel id, trailer, home hero preset and viewer-authorization state observed in the probe, useful when mirroring how a channel page is configured.

Live API Demo

GET /api/project/twitch-scraper/get-channel-details

Request cost is temporarily unavailable. No price is assumed.

View pricing

API Response (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/twitch-scraper/get-channel-details?key=<API_KEY>&channel=ninja'
📢
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Contact Us

Use Cases

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.

Related operations

Guides

View Subscription Plans →