# 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). {% 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 %} #### 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.
FilterList of channels, top 100, creditsList of channels, each next page (top 200, etc.), credits
No specific filter (overall top)2010
Language (English, Spanish, Portuguese, etc.)2010
Platform’s partnership (Twitch partners, Twitch Affiliates)2010
Country (USA, Brazil, etc.)4020
Gender (male, female)4020
VTubers (list of all VTubers from Twitch)4020
{% hint style="info" %} 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. {% endhint %} #### 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' ``` *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", "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 {% hint style="info" %} For languages, we use [ISO 639-1 Language Codes](https://lingohub.com/academy/best-practices/iso-639-1-list), a two-character code that serves as identifiers for major (macro) languages worldwide. {% endhint %} 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' ``` *Use your Client ID and token instead of "XXXXXXXXXXXX" and "YYYYYYYYYYYYYY", which you can find* [*here*](https://streamscharts.com/api/token)*.* ### 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: 
curl -X GET https://streamscharts.com/api/jazz/subscribers?partner=only_partners \
-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)*.* ### Country {% hint style="info" %} For countries, we use [ISO 3166 Alpha-2 Codes](https://www.iban.com/country-codes), 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. {% endhint %} 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' ``` *Use your Client ID and token instead of "XXXXXXXXXXXX" and "YYYYYYYYYYYYYY", which you can find* [*here*](https://streamscharts.com/api/token)*.* ### Gender (Channel type) Supported values: ``` female; male; organization ``` {% hint style="info" %} 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. {% endhint %} 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' ``` *Use your Client ID and token instead of "XXXXXXXXXXXX" and "YYYYYYYYYYYYYY", which you can find* [*here*](https://streamscharts.com/api/token)*.* ### VTubers VTubers are [one of the main phenomena](https://streamscharts.com/news/who-are-vtubers-and-why-are-they-popular) 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. 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' ``` *Use your Client ID and token instead of "XXXXXXXXXXXX" and "YYYYYYYYYYYYYY", which you can find* [*here*](https://streamscharts.com/api/token)*.* [^1]: --- # 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/list-of-top-twitch-channels-by-paid-subscribers.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.