The first call for stream's metrics costs 1 or 2 credits, depending on the set of metrics (see the difference below). All further requests to streams of specific channel within the next 30 days will cost 0.2 and 0.4 credits accordingly. On day 31, it will cost another credit or two again for the first API call.
Available data sets of metrics
Set of metrics
1st request to stream stats of a specific channel, credits
each next request to stream stats of a specific channel within next 30 days, credits
1
0.2
2
0.4
1
0.2
1
0.4
Standard set of metrics
Available platforms
One request will provide you with data for one specific channel only. Since the channel can broadcast on different platforms with the same name, use the filter by platform: platform={name}. Supported values:
How to access the standard set of metrics for single stream stats
You will need a Client ID and a token to use Streams Charts API. Your Client ID is bound to your account and can never be changed, but you can change your access token anytime for security reasons.
Use the example request below to see how it works with a standard set of metrics for a single stream of a specific channel.
If needed, you can select a stream time to get statistics only for a specific part of the stream (e.g., for a particular broadcast hours or even minutes). To do this, use the parameter time={value} in the format YYYY-MM-DD HH:MM,YYYY-MM-DD HH:MM
Request example
curl -X GET https://streamscharts.com/api/jazz/channels/caedrel/streams/43526722936?platform=twitch&time=2025-01-07 10:00,2025-01-07 13:00 \
-H 'Client-ID: XXXXXXXXXXXX' \
-H 'Token: YYYYYYYYYYYYYY'
Extra set of metrics
By extra metrics, we mean that in return for the standard set of metrics, you will also get the following ones:
One request will provide you with data for one stream of a specific channel only. Since an extra set of metrics is available only for Twitch channels, use the filter platform=twitch to get it.
How to access the extra set of metrics for single channel stats
You will need a Client ID and a token to use Streams Charts API. Your Client ID is bound to your account and can never be changed, but you can change your access token anytime for security reasons.
To get an extra set of metrics by one stream of a specific channel, use the next route: /api/jazz/channels/{name}/streams-extra/{stream-id}?platform=twitch
To see how it works with an extra set of metrics for a single stream of a specific channel, use the example request below.
From April 3, 2023, such metrics as Authorized Viewers and Unique Viewers are available only for channels authorized on Streams Charts via Twitch. Historical data is still available for all Twitch channels.
Supported time periods
If needed, you can select a stream time to get statistics only for a specific part of the stream (e.g., for a particular broadcast hours or even minutes). To do this, use the parameter time={value} in the format YYYY-MM-DD HH:MM,YYYY-MM-DD HH:MM
Request example
curl -X GET https://streamscharts.com/api/jazz/channels/caedrel/streams-extra/43526722936?platform=twitch&time=2025-01-07 10:00,2025-01-07 13:00 \
-H 'Client-ID: XXXXXXXXXXXX' \
-H 'Token: YYYYYYYYYYYYYY'
Paid subscribers set of metrics
Available platforms
One request will provide you with data for one stream of a specific channel only. Since a paid subscribers set of metrics is available only for Twitch channels, use the filter platform=twitch to get it.
How to access the extra set of metrics for single channel stats
You will need a Client ID and a token to use Streams Charts API. Your Client ID is bound to your account and can never be changed, but you can change your access token anytime for security reasons.
To get a paid subscribers set of metrics by one stream of a specific channel, use the following route: /api/jazz/channels/{name}/streams-extra/{stream-id}/subs?platform=twitch
To see how it works with paid subscribers' set of metrics for a single stream of a specific channel, use the example request below.
The Twitch streamers themselves do not verify Streams Charts calculations. We use our own methodology, and the numbers may not coincide with the original values.
Our calculations usually do not consider subscriptions when the channel is offline, and we do not track auto-renewed subscriptions unless the viewer clicks the appropriate button in chat to notify the streamer about his auto-renewal.
Supported time periods
If needed, you can select a stream time to get statistics only for a specific part of the stream (e.g., for a particular broadcast hours or even minutes). To do this, use the parameter time={value} in the format YYYY-MM-DD HH:MM,YYYY-MM-DD HH:MM
Request example
curl -X GET https://streamscharts.com/api/jazz/channels/caedrel/streams-extra/43526722936/subs?platform=twitch&time=2025-01-07 10:00,2025-01-07 13:00 \
-H 'Client-ID: XXXXXXXXXXXX' \
-H 'Token: YYYYYYYYYYYYYY'
Chat analytics set of metrics
Available platforms
One request will provide you with data for one stream of a specific channel only. Since a chat analytics set of metrics is available only for Twitch channels, use the filter platform=twitch to get it.
How to access the extra set of metrics for single channel stats
You will need a Client ID and a token to use Streams Charts API. Your Client ID is bound to your account and can never be changed, but you can change your access token anytime for security reasons.
To get a chat analytics set of metrics by one stream of a specific channel, use the following route: /api/jazz/channels/{name}/streams-extra/{stream-id}/chat?platform=twitch
To see how it works with a chat analytics set of metrics for a single stream of a specific channel, use the example request below.
If needed, you can select a stream time to get statistics only for a specific part of the stream (e.g., for a particular broadcast hours or even minutes). To do this, use the parameter time={value} in the format YYYY-MM-DD HH:MM,YYYY-MM-DD HH:MM
Request example
curl -X GET https://streamscharts.com/api/jazz/channels/caedrel/streams-extra/43526722936/chat?platform=twitch&time=2025-01-07 10:00,2025-01-07 13:00 \
-H 'Client-ID: XXXXXXXXXXXX' \
-H 'Token: YYYYYYYYYYYYYY'
Use your Client ID and token instead of "XXXXXXXXXXXX" and "YYYYYYYYYYYYYY", which you can find .
Use your Client ID and token instead of "XXXXXXXXXXXX" and "YYYYYYYYYYYYYY", which you can find .
Use your Client ID and token instead of "XXXXXXXXXXXX" and "YYYYYYYYYYYYYY", which you can find .