Streams Charts Live-Streaming API Docs
Streams Charts Home PageAPI OverviewToken & CreditsAccess HistorySupport
  • ⚙️Streams Charts Live Streaming API Overview
  • 📉Single channel stats
  • 📊Single stream stats
  • 📗List of channels by different metrics and filters
  • 📘List of top Twitch channels by paid subscribers
  • 📒List of top Twitch channels by bits
  • ✏️Testing mode
  • 🆓FREE request
Powered by GitBook
On this page
  • Standard set of metrics
  • Extra set of metrics
  • Paid subscribers set of metrics
  • Chat analytics set of metrics

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:

twitch; youtube; kick; rumble; trovo; nimo; bigo; nonolive; afreecatv; mildom; chzzk; soop; steam

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:

today; 7-days; 30-days; 90-days; this-month; last-month; this-year; last-year; YYYY-MM-DD,YYYY-MM-DD

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

Request example

curl -X GET https://streamscharts.com/api/jazz/channels/cohhcarnage?platform=twitch&time=2025-01-01 13:00,2025-01-05 22:10 \
-H 'Client-ID: XXXXXXXXXXXX' \
-H 'Token: YYYYYYYYYYYYYY'

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.

curl -X GET https://streamscharts.com/api/jazz/channels/shroud?platform=twitch \
-H 'Client-ID: XXXXXXXXXXXX' \
-H 'Token: YYYYYYYYYYYYYY'

The response you would get would be a JSON response that contains something like a sample response:

{
"data":{
"platform": "twitch",
"channel_name": "shroud",
"channel_display_name": "shroud",
"channel_id": "37402112",
"hours_watched": 2554370,
"peak_viewers": 33925,
"average_viewers": 16262,
"airtime_in_m": 9425,
"followers_gain": 9574,
"followers_gain_per_h": 61,
"total_followers": 10602496,
"stream_count": 18,
"streams_list":[
{
"id": "48882015229",
"name": "life of a gamer !mggiveaway",
"date": "2023-07-16 20:45:00"
},
{
"id": "48855028893",
"name": "FIREBALL --> shroud.gg <-> shroud shroud shroud shroud shroud shroud shroud",
"date": "2023-07-13 20:45:00"
},
…
],
"games_count": 3,
"top_5_games_by_hw":[
{
"name": "Diablo IV",
"hours_watched": 2488439,
"%_of_hours_watched": 97.4
},
{
"name": "BattleBit Remastered",
"hours_watched": 65246,
"%_of_hours_watched": 2.6
},
{
"name": "Just Chatting",
"hours_watched": 685,
"%_of_hours_watched": 0
}
],
"stream_days": 25,
"avatar_url": "https://static-cdn.jtvnw.net/jtv_user_pictures/7ed5e0c6-0191-4eef-8328-4af6e4ea5318-profile_image-300x300.png",
"channel_country": "CA",
"stream_language": "en",
"partnership_status": "partner",
"channel_type": "Male"
}
}

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:

followers_gain; followers_gain_per_h; total_followers; partnership_status

YouTube, Trovo, Nonolive, Mildom:

partnership_status

Rumble:

followers_gain; followers_gain_per_h; total_followers; games_count; top_5_games_by_hw

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:

Example of response
...
"extra_metrics":{
"live_views": 17636629,
"unique_viewers": 3210179,
"unique_auth_viewers": 2696550,
"auth_viewers_average_view_duration_in_m": 76,
"authorized_to_all_viewers_ratio_%": 84,
"avg_daily_estimated_audience": 234358,
"avg_daily_estimated_audience_average_view_duration_in_m": 47
}
...

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:

today; 7-days; 30-days; 90-days; this-month; last-month; this-year; last-year; YYYY-MM-DD,YYYY-MM-DD

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

Request example

curl -X GET https://streamscharts.com/api/jazz/channels-extra/cohhcarnage?platform=twitch&time=2025-01-01 13:00,2025-01-05 22:10 \
-H 'Client-ID: XXXXXXXXXXXX' \
-H 'Token: YYYYYYYYYYYYYY'

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.

curl -X GET https://streamscharts.com/api/jazz/channels-extra/shroud?platform=twitch \
-H 'Client-ID: XXXXXXXXXXXX' \
-H 'Token: YYYYYYYYYYYYYY'

The response you would get would be a JSON response that contains something like a sample response:

{
"data":{
"platform": "twitch",
"channel_name": "shroud",
"channel_display_name": "shroud",
"channel_id": "37402112",
"hours_watched": 4397224,
"peak_viewers": 158564,
"average_viewers": 22503,
"airtime_in_m": 11725,
"followers_gain": 58596,
"followers_gain_per_h": 299.9,
"total_followers": 10503756,
"stream_count": 21,
"streams_list":[{"id": "42019886731", "name": "s3 cycle --> !announcement", "date": "2023-03-29 18:30:00"…],
"games_count": 12,
"top_5_games_by_hw":[{"name": "Counter-Strike: Global Offensive", "hours_watched": 1218921, "%_of_hours_watched": 27.7 },…],
"stream_days": 24,
"avatar_url": "https://static-cdn.jtvnw.net/jtv_user_pictures/7ed5e0c6-0191-4eef-8328-4af6e4ea5318-profile_image-300x300.png",
"channel_country": "CA",
"stream_language": "en",
"partnership_status": "partner",
"channel_type": "Male",
"extra_metrics":{
"live_views": 17636629,
"unique_viewers": 3210179,
"unique_auth_viewers": 2696550,
"auth_viewers_average_view_duration_in_m": 76,
"authorized_to_all_viewers_ratio_%": 84,
"avg_daily_estimated_audience": 234358,
"avg_daily_estimated_audience_average_view_duration_in_m": 47
}
}
}

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:

today; 7-days; 30-days; 90-days; this-month; last-month; this-year; last-year; YYYY-MM-DD,YYYY-MM-DD

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

Request example

curl -X GET https://streamscharts.com/api/jazz/channels-extra/cohhcarnage/subs?platform=twitch&time=2025-01-01 13:00,2025-01-05 22:10 \
-H 'Client-ID: XXXXXXXXXXXX' \
-H 'Token: YYYYYYYYYYYYYY'

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.

curl -X GET https://streamscharts.com/api/jazz/channels-extra/shroud/subs?platform=twitch \
-H 'Client-ID: XXXXXXXXXXXX' \
-H 'Token: YYYYYYYYYYYYYY'

The response you would get would be a JSON response that contains something like a sample response:

{
"data":{
"platform": "twitch",
"channel_name": "shroud",
"channel_display_name": "shroud",
"channel_id": "37402112",
"avatar_url": "https://static-cdn.jtvnw.net/jtv_user_pictures/7ed5e0c6-0191-4eef-8328-4af6e4ea5318-profile_image-300x300.png",
"stream_language": "en",
"partnership_status": "partner",
"total_subs": 3429,
"min_income_from_subs_in_$": 5083,
"max_income_from_subs_in_$": 8889,
"paid_subs": 2180,
"gifted_subs": 1249,
"prime_subs": 1388,
"tier_1_subs": 2018,
"tier_2_subs": 1,
"tier_3_subs": 22
}
}

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:

today; 7-days; 30-days; 90-days; this-month; last-month; this-year; last-year; YYYY-MM-DD,YYYY-MM-DD

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

Request example

curl -X GET https://streamscharts.com/api/jazz/channels-extra/cohhcarnage/chat?platform=twitch&time=2025-01-01 13:00,2025-01-05 22:10 \
-H 'Client-ID: XXXXXXXXXXXX' \
-H 'Token: YYYYYYYYYYYYYY'

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.

curl -X GET https://streamscharts.com/api/jazz/channels-extra/shroud/chat?platform=twitch \
-H 'Client-ID: XXXXXXXXXXXX' \
-H 'Token: YYYYYYYYYYYYYY'

The response you would get would be a JSON response that contains something like a sample response:

{
"data":{
"platform": "twitch",
"channel_name": "shroud",
"channel_display_name": "shroud",
"channel_id": "37402112",
"avatar_url": "https://static-cdn.jtvnw.net/jtv_user_pictures/7ed5e0c6-0191-4eef-8328-4af6e4ea5318-profile_image-300x300.png",
"stream_language": "en",
"partnership_status": "partner",
"total_messages": 258088,
"total_words_count": 1213817,
"active_chatters": 47609,
"avg_daily_passive_chatters": 134091,
"avg_daily_engagement_rate_%": 2.5,
"messages_per_chatter": 5.4,
"chatters_with_1_message": 23780,
"chatters_with_2+_message": 23829,
"cheer_messages": 9,
"cheer_chatters": 9,
"total_bits": 12000,
"income_from_bits_in_$": 120,
"bits_per_cheered_message": 1333,
"bits_per_cheered_chatter": 1333
}
}
PreviousStreams Charts Live Streaming API OverviewNextSingle stream stats

Last updated 4 months ago

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 .

Use your Client ID and token instead of "XXXXXXXXXXXX" and "YYYYYYYYYYYYYY", which you can find .

📉
here
here
here
here
Standard (available for 10+ platforms)
Extra (Twitch only)
Paid subscribers (Twitch only)
Chat analytics (Twitch only)