# Single stream stats 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 metrics1st request to stream stats of a specific channel, creditseach next request to stream stats of a specific channel within next 30 days, credits
Standard (available for 10+ platforms)10.2
Extra (Twitch only)20.4
Standard + all stream games (available for 10+ platforms) [NEW]20.4
Paid subscribers (Twitch only)10.2
Chat analytics (available for Twitch, Kick and YouTube Gaming)10.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: ``` twitch; youtube; kick; rumble; trovo; nimo; bigo; nonolive; afreecatv; mildom; chzzk; soop; steam ``` #### 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. ``` curl -X GET https://streamscharts.com/api/jazz/channels/shroud/streams/41976921163?platform=twitch \ -H 'Client-ID: XXXXXXXXXXXX' \ -H 'Token: YYYYYYYYYYYYYY' ``` {% hint style="info" %} For YouTube channels, use **channel ID** in the request to get a correct response. I.e., `https://streamscharts.com/api/jazz/channels/``UCWsDFcIhY2DBi3GB5uykGXA``/streams-extra/10203361939495629149/chat?platform=youtube` {% endhint %} *Use your Client ID and token instead of "XXXXXXXXXXXX" and "YYYYYYYYYYYYYY", which you can find* [*here*](https://streamscharts.com/api/token)*.* The response you would get would be a JSON response that contains something like a sample response: ```json { "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_id": "41976921163", "stream_status": "making my sorc NOW also check out !announcement", "stream_start": "2023-03-18 19:05:30", "stream_end": "2023-03-19 03:35:00", "stream_language": "en", "hours_watched": 115906, "airtime_in_m": 515, "peak_viewers": 17819, "average_viewers": 13504, "followers_gain": 676, "top_game_by_hw": "Diablo IV", "top_game_by_hw_%": 81.7 } } ``` #### Excluding NimoTV, Bigo LIVE, Nonolive, AfreecaTV, CHZZK, SOOP, SteamTV: ``` followers_gain ``` Rumble: ``` followers_gain; top_game_by_hw, top_game_by_hw_% ``` #### 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/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: {% code title="Example of response" %} ```json ... "extra_metrics":{ "live_views": 464087, "unique_viewers": 176871, "unique_auth_viewers": 147068, "peak_auth_viewers": 13674, "auth_viewers_average_view_duration_in_m": 43, "authorized_to_all_viewers_ratio_%": 83, "viewers_from_last_stream_%": 69.4, "returned_viewers_%": 35.3, "estimated_audience": 166405, "estimated_audience_average_view_duration_in_m": 42 } ... ``` {% endcode %} #### Available platforms 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. ``` curl -X GET https://streamscharts.com/api/jazz/channels/shroud/streams-extra/41976921163?platform=twitch \ -H 'Client-ID: XXXXXXXXXXXX' \ -H 'Token: YYYYYYYYYYYYYY' ``` *Use your Client ID and token instead of "XXXXXXXXXXXX" and "YYYYYYYYYYYYYY", which you can find* [*here*](https://streamscharts.com/api/token)*.* The response you would get would be a JSON response that contains something like a sample response: ```json { "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_id": "41976921163", "stream_status": "making my sorc NOW also check out !announcement", "stream_start": "2023-03-18 19:05:30", "stream_end": "2023-03-19 03:35:00", "stream_language": "en", "hours_watched": 115906, "airtime_in_m": 515, "peak_viewers": 17819, "average_viewers": 13504, "followers_gain": 676, "top_game_by_hw": "Diablo IV", "top_game_by_hw_%": 81.7, "extra_metrics":{ "live_views": 464087, "unique_viewers": 176871, "unique_auth_viewers": 147068, "peak_auth_viewers": 13674, "auth_viewers_average_view_duration_in_m": 43, "authorized_to_all_viewers_ratio_%": 83, "viewers_from_last_stream_%": 69.4, "returned_viewers_%": 35.3, "estimated_audience": 166405, "estimated_audience_average_view_duration_in_m": 42 } } } ``` {% hint style="info" %} 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. {% endhint %} #### 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'
### 'Standard + all stream games' set of metrics By this set metrics, we mean that in return for the standard set of metrics, you will also get the following ones: {% code title="Example of response" %} ```json ... "all_stream_games":[ { "name": "Rocket League", "hours_watched": 161731, "peak_viewers": 64933, "average_viewers": 41293, "airtime_in_m": "235", "followers_gain": "3044" }, { "name": "Just Chatting", "hours_watched": 35980, "peak_viewers": 50507, "average_viewers": 39250, "airtime_in_m": "55", "followers_gain": "918" }, ... { "name": "Geometry Dash", "hours_watched": 7131, "peak_viewers": 32448, "average_viewers": 28523, "airtime_in_m": "15", "followers_gain": "142" } ] ... ``` {% endcode %} #### 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; trovo; nimo; bigo; nonolive; afreecatv; mildom; chzzk; soop; steam ``` #### How to access 'standard + all stream games' 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}/games?platform={platform}` To see how it works for a single stream of a specific channel, use the example request below. ``` curl -X GET https://streamscharts.com/api/jazz/channels/jynxzi/streams-extra/317797555547/games?platform=twitch \ -H 'Client-ID: XXXXXXXXXXXX' \ -H 'Token: YYYYYYYYYYYYYY' ``` *Use your Client ID and token instead of "XXXXXXXXXXXX" and "YYYYYYYYYYYYYY", which you can find* [*here*](https://streamscharts.com/api/token)*.* The response you would get would be a JSON response that contains something like a sample response: ```json { "data": { "platform": "twitch", "channel_name": "jynxzi", "channel_display_name": "Jynxzi", "channel_id": "411377640", "avatar_url": "https://static-cdn.jtvnw.net/jtv_user_pictures/645d98a0-a2eb-48a3-b687-cfbc55243e4a-profile_image-300x300.png", "stream_id": "317797555547", "stream_status": "[407/730] πŸ”΄ Almost Platinum -> 99-0 vs SQUISHY @ 7PM EST πŸ”΄", "stream_start": "2026-02-11 20:56:41", "stream_end": "2026-02-12 02:00:00", "stream_language": "en", "hours_watched": 204840, "airtime_in_m": 305, "peak_viewers": 64933, "average_viewers": 40297, "followers_gain": 4104, "top_game_by_hw": "Rocket League", "top_game_by_hw_%": 79, "all_stream_games": [ { "name": "Rocket League", "hours_watched": 161731, "peak_viewers": 64933, "average_viewers": 41293, "airtime_in_m": "235", "followers_gain": "3044" }, { "name": "Just Chatting", "hours_watched": 35980, "peak_viewers": 50507, "average_viewers": 39250, "airtime_in_m": "55", "followers_gain": "918" }, { "name": "Geometry Dash", "hours_watched": 7131, "peak_viewers": 32448, "average_viewers": 28523, "airtime_in_m": "15", "followers_gain": "142" } ] } } ``` ### 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. ``` curl -X GET https://streamscharts.com/api/jazz/channels/shroud/streams-extra/41976921163/subs?platform=twitch \ -H 'Client-ID: XXXXXXXXXXXX' \ -H 'Token: YYYYYYYYYYYYYY' ``` *Use your Client ID and token instead of "XXXXXXXXXXXX" and "YYYYYYYYYYYYYY", which you can find* [*here*](https://streamscharts.com/api/token)*.* The response you would get would be a JSON response that contains something like a sample response: ```json { "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_id": "41976921163", "stream_status": "making my sorc NOW also check out !announcement", "stream_start": "2023-03-18 19:05:30", "stream_end": "2023-03-19 03:35:00", "stream_language": "en", "total_subs": 78, "min_income_from_subs_in_$": 147, "max_income_from_subs_in_$": 210, "new_subs": 34, "re_subs": 39, "paid_subs": 73, "gifted_subs": 5, "prime_subs": 48, "tier_1_subs": 29, "tier_2_subs": 0, "tier_3_subs": 1 } } ``` {% hint style="info" %} 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. {% endhint %} #### 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 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 ``` {% hint style="info" %} Twitch chat data available for 200,000+ channels since January 2022. For Kick it available for 70,000+ channels since July 2025, and for YouTube only for top Gaming channels since July 2025. {% endhint %} #### How to access the chat analytics 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. ``` curl -X GET https://streamscharts.com/api/jazz/channels/shroud/streams-extra/41976921163/chat?platform=twitch \ -H 'Client-ID: XXXXXXXXXXXX' \ -H 'Token: YYYYYYYYYYYYYY' ``` {% hint style="info" %} For YouTube channels, use **channel ID** in the request to get a correct response. I.e., `https://streamscharts.com/api/jazz/channels/``UCWsDFcIhY2DBi3GB5uykGXA``/streams-extra/10203361939495629149/chat?platform=youtube` {% endhint %} *Use your Client ID and token instead of "XXXXXXXXXXXX" and "YYYYYYYYYYYYYY", which you can find* [*here*](https://streamscharts.com/api/token)*.* The response you would get for **Twitch chat data** would be a JSON response that contains something like a sample response: ```json { "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_id": "41976921163", "stream_status": "making my sorc NOW also check out !announcement", "stream_start": "2023-03-18 19:05:30", "stream_end": "2023-03-19 03:35:00", "stream_language": "en", "total_messages": 9728, "total_words_count": 64447, "active_chatters": 3579, "passive_chatters": 143478, "messages_per_chatter": 2.7, "chat_engagement_rate_%": 2.4337501785, "chatters_with_1_message": 2198, "chatters_with_2+_message": 1381, "cheer_messages": 1, "cheer_chatters": 1, "total_bits": 1000, "income_from_bits_in_$": 10, "bits_per_cheered_message": 1000, "bits_per_cheered_chatter": 1000 } } ``` The response you would get for **YouTube or Kick chat data** would be a JSON response that contains something like a sample response: ```json { "data":{ "platform": "youtube", "channel_name": "UCWsDFcIhY2DBi3GB5uykGXA", "channel_display_name": "IShowSpeed", "channel_id": "13532889483798049063", "avatar_url": "https://yt3.googleusercontent.com/ieK0j0sDqI_AHDwYxZ2Wly07-R7PG4S3YMtxOWCEe1QH-I0FgimJ92tlydQa6M78YD0VaywCaw", "stream_id": "10203361939495629149", "stream_status": "24/7 irl stream in America πŸ‡ΊπŸ‡Έ Day 25 of 35 (Salt Lake City, UT) pt 2", "stream_start": "2025-09-22 03:40:43", "stream_end": "2025-09-22 15:45:00", "stream_language": "en", "total_messages": 101879, "total_words_count": 324669, "active_chatters": 17866, "messages_per_chatter": 5.7, "chatters_with_1_message": 8282, "chatters_with_2+_message": 9584, "active_chatters_to_viewers_ratio_%": 1.1 } } ``` #### 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/chat?platform=twitch&time=2025-01-07 10:00,2025-01-07 13:00 \
-H 'Client-ID: XXXXXXXXXXXX' \
-H 'Token: YYYYYYYYYYYYYY'
--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://streams-charts.gitbook.io/streams-charts-live-streaming-api-docs/single-stream-stats.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.