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
  • Filters supported values
  • Language
  • Platform’s partnership
  • Country
  • Gender (Channel type)
  • VTubers

List of top Twitch channels by paid subscribers

Here you can get a list of Twitch channels by paid subscribers. Streamers can be filtered by language, partner status, country, gender, and VTubers type. Here you can also select the time period for which you want the data — from the last 7 days to the statistics for the year (365 days).

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.

Available filters

Each request will be sorted by the total number of subscribers by default. The maximum period of time per request is 365 days, with the number of rows per request equal to 100.

Filter

List of channels, top 100, credits

List of channels, each next page (top 200, etc.), credits

20

10

20

10

20

10

40

20

40

20

40

20

If you combine, for example, filter by the language (which costs 20 credits) with filter by country (which costs 40 credits), the system will charge the bigger amount - 40 credits.

Supported time periods

You get a list of channels sorted by total subscribers for the last 30 days by default. To select a different time period, use the filter time={value}. The maximum period of time per one TOP is 365 days. Supported values:

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

Pagination

You get 100 rows per page by default. To see other pages, use paginations, e.g. page=2

How to access the list of channels by paid subscribers data set

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 see how it works with a list of channels by paid subscribers, see an example request below:

curl -X GET https://streamscharts.com/api/jazz/subscribers \
-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": "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",
"channel_country": "US",
"stream_language": "en",
"partnership_status": "partner",
"channel_type": "Male",
"total_subs": 88130,
"min_income_from_subs_in_$": 132391,
"max_income_from_subs_in_$": 220370,
"paid_subs": 67506,
"gifted_subs": 20624,
"prime_subs": 38051,
"tier_1_subs": 50019,
"tier_2_subs": 36,
"tier_3_subs": 24
},
{
"platform": "twitch",
"channel_name": "paymoneywubby",
"channel_display_name": "PaymoneyWubby",
"channel_id": "38251312",
"avatar_url": "https://static-cdn.jtvnw.net/jtv_user_pictures/6624a175-5e4c-4d12-aaeb-993810378640-profile_image-300x300.png",
"channel_country": "US",
"stream_language": "en",
"partnership_status": "partner",
"channel_type": "Male",
"total_subs": 50826,
"min_income_from_subs_in_$": 49241,
"max_income_from_subs_in_$": 128452,
"paid_subs": 12655,
"gifted_subs": 38171,
"prime_subs": 6220,
"tier_1_subs": 44432,
"tier_2_subs": 84,
"tier_3_subs": 90
},
{"platform": "twitch", "channel_name": "tumblurr", "channel_display_name": "Tumblurr", "channel_id": "77827128",…},
{"platform": "twitch", "channel_name": "gaules", "channel_display_name": "Gaules", "channel_id": "181077473",…},
...
{"platform": "twitch", "channel_name": "tck10", "channel_display_name": "TcK10", "channel_id": "499928989",…},
{"platform": "twitch", "channel_name": "gabepeixe", "channel_display_name": "gabepeixe", "channel_id": "59799994",…}
],
"links":{
"first": "https://streamscharts.com/api/jazz/subscribers?page=1",
"next": "https://streamscharts.com/api/jazz/subscribers?page=2"
},
"meta":{
"current_page": 1,
"from": 1,
"path": "https://streamscharts.com/api/jazz/subscribers",
"per_page": 100,
"to": 100
},
"filters":[]
}

Filters supported values

Language

To filter a list of channels by language, use the filter lang={name}, e.g. lang=en

Request example:

curl -X GET https://streamscharts.com/api/jazz/subscribers?lang=en \
-H 'Client-ID: XXXXXXXXXXXX' \
-H 'Token: YYYYYYYYYYYYYY'

Platform’s partnership

Supported values:

only_partners; only_affiliates

To filter a list of channels by platform’s partnership, use the filter partner={value}, e.g., partner=only_partners

Request example:

-X GET https://streamscharts.com/api/jazz/subscribers?partner=only_partners \
-H 'Client-ID: XXXXXXXXXXXX' \
-H 'Token: YYYYYYYYYYYYYY'

Country

To filter a list of channels by country, use the filter country={alpha‑2 code}, e.g. country=US to get a list of channels from the USA.

Request example:

curl -X GET https://streamscharts.com/api/jazz/subscribers?country=US \
-H 'Client-ID: XXXXXXXXXXXX' \
-H 'Token: YYYYYYYYYYYYYY'

Gender (Channel type)

Supported values:

female; male; organization

Organization type includes esports, studio, and game publisher channels. Note that all gender information is based on user contributions and is available for hundreds of thousands of channels.

To filter a list of channels by gender, use the filter type={value}, e.g., type=female, to see a list of female streamers by paid subscribers.

Request example:

curl -X GET https://streamscharts.com/api/jazz/subscribers?type=female \
-H 'Client-ID: XXXXXXXXXXXX' \
-H 'Token: YYYYYYYYYYYYYY'

VTubers

To see a list of Twitch VTubers by paid subscribers, use the filter vtuber=all

Request example:

curl -X GET https://streamscharts.com/api/jazz/subscribers?vtuber=all \
-H 'Client-ID: XXXXXXXXXXXX' \
-H 'Token: YYYYYYYYYYYYYY'
PreviousList of channels by different metrics and filtersNextList of top Twitch channels by bits

Last updated 1 year ago

(overall top)

(English, Spanish, Portuguese, etc.)

(Twitch partners, Twitch Affiliates)

(USA, Brazil, etc.)

(male, female)

(list of all VTubers from Twitch)

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

For languages, we use , a two-character code that serves as identifiers for major (macro) languages worldwide.

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 .

For countries, we use , a two-character code that serves as identifiers for major countries worldwide. Note that all country information is based on user contributions and is available for hundreds of thousands of channels.

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 .

VTubers are of recent years in the digital entertainment industry. Streamers with digital avatars gather thousands of viewers on their broadcasts regularly and have long been competing on equal terms with other top content creators. Streams Charts has collected an extensive database of top VTubers on all popular live streaming platforms.

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

📘
here
ISO 639-1 Language Codes
here
here
ISO 3166 Alpha-2 Codes
here
here
one of the main phenomena
here
No specific filter
Language
Platform’s partnership
Country
Gender
VTubers