Single channel stats
The first call for the channel's metrics costs 1 or 2 credits, depending on the set of metrics (see the difference below).
Next calls cost 0.1 and 0.2 credits for less than 14 days period (i.e., if the data period you request is less than 14 days, for example, from April 1 to April 10), 0.3 and 0.6 credits for the over 14 days period accordingly (i.e., if the data period you request is more than 14 days, for example, from April 1 to April 25).
On day 31, since your first request, it will cost another credit or two again for the first API call for a specific channel.
Available data sets of metrics
Set of metrics
1st request, credits
each next request, ≤ 14 days time period, credits
each next request, > 14 days time period, credits
1
0.1
0.3
2
0.2
0.6
1
0.1
0.3
1
0.1
0.3
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:
Supported time periods
Use the filter time={value} to select a different time period. If you do not specify a time period, you will get data for the last 30 days by default. Supported values:
If needed, you can select a specific time period of channel stats down to the hours and minutes. To do this, add a time range in the filter time={value} in the next format: YYYY-MM-DD HH:MM,YYYY-MM-DD HH:MM
Note: With the exact time, you can select only within the 7-day range.
How to access the standard 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.
Use the example request below to see how it works with a standard set of metrics for a single channel stats.
Use your Client ID and token instead of "XXXXXXXXXXXX" and "YYYYYYYYYYYYYY", which you can find here.
The response you would get would be a JSON response that contains something like a sample response:
For YouTube channels, use channel ID in the request to get a correct response. I.e., https://streamscharts.com/api/jazz/channels/UC1dGHGJTXU_dkiR8tW3qQgg?platform=youtube
Excluding
NimoTV, Bigo LIVE, AfreecaTV, CHZZK, SOOP, SteamTV:
YouTube, Trovo, Nonolive, Mildom:
Rumble:
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:
Available platforms
One request will provide you with data for one specific channel only. Since an extra set of metrics is available only for Twitch channels, use the filter platform=twitch to get it.
Supported time periods
Use the filter time={value} to select a different time period. If you do not specify a time period, you will get data for the last 30 days by default. Supported values:
If needed, you can select a specific time period of channel stats down to the hours and minutes. To do this, add a time range in the filter time={value} in the next format: YYYY-MM-DD HH:MM,YYYY-MM-DD HH:MM
Note: With the exact time, you can select only within the 7-day range.
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 channel, use the following route: /api/jazz/channels-extra/{name}?platform=twitch
To see how it works with an extra set of metrics for a single channel stats, use the example request below.
Use your Client ID and token instead of "XXXXXXXXXXXX" and "YYYYYYYYYYYYYY", which you can find here.
The response you would get would be a JSON response that contains something like a sample response:
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.
Paid subscribers set of metrics
Available platforms
One request will provide you with data for one specific channel only. Since a paid subscribers set of metrics is available only for Twitch channels, use the filter platform=twitch to get it.
Supported time periods
Use the filter time={value} to select a different time period. If you do not specify a time period, you will get data for the last 30 days by default. Supported values:
If needed, you can select a specific time period of channel stats down to the hours and minutes. To do this, add a time range in the filter time={value} in the next format: YYYY-MM-DD HH:MM,YYYY-MM-DD HH:MM
Note: With the exact time, you can select only within the 7-day range.
How to access the paid subscribers' 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 paid subscribers set of metrics by one channel, use the following route: /api/jazz/channels-extra/{name}/subs?platform=twitch
To see how it works with paid subscribers' set of metrics for single channel stats, use the example request below.
Use your Client ID and token instead of "XXXXXXXXXXXX" and "YYYYYYYYYYYYYY", which you can find here.
The response you would get would be a JSON response that contains something like a sample response:
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.
Chat analytics set of metrics
Available platforms
One request will provide you with data for one specific channel only. Since a chat analytics set of metrics is available only for Twitch channels, use the filter platform=twitch to get it.
Supported time periods
Use the filter time={value} to select a different time period. If you do not specify a time period, you will get data for the last 30 days by default. Supported values:
If needed, you can select a specific time period of channel stats down to the hours and minutes. To do this, add a time range in the filter time={value} in the next format: YYYY-MM-DD HH:MM,YYYY-MM-DD HH:MM
Note: With the exact time, you can select only within the 7-day range.
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 chat analytics set of metrics by one channel, use the next route: /api/jazz/channels-extra/{name}/chat?platform=twitch
To see how it works with a chat analytics set of metrics for a single channel stats, use the example request below.
Use your Client ID and token instead of "XXXXXXXXXXXX" and "YYYYYYYYYYYYYY", which you can find here.
The response you would get would be a JSON response that contains something like a sample response:
Last updated