# List of channels by different metrics and filters

You can get any specific channel top in our API by selecting the necessary filters. Streamers can be filtered by game, broadcast language, partner status, age, country, and other parameters. 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).

#### Available filters

Each request will be sorted by Hours Watched by default. Other sorting options you can see below. The maximum period of time per request is 365 days, with the number of rows per request equal to 100.

<table data-header-hidden><thead><tr><th width="400.3333333333333"></th><th></th><th></th></tr></thead><tbody><tr><td><strong>Filter</strong></td><td><strong>List of channels, top 100, credits</strong></td><td><strong>List of channels, each next page (top 200, etc.), credits</strong></td></tr><tr><td><a href="#how-to-access-the-list-of-channels-data-set">No specific filters</a> (overall top by platform)</td><td>20</td><td>10</td></tr><tr><td><a href="#language">Language</a> (English, Spanish, Portuguese, etc.)</td><td>20</td><td>10</td></tr><tr><td><a href="#game-category">Game/Category</a> (CS:GO, Minecraft, Just Chatting, etc.)</td><td>20</td><td>10</td></tr><tr><td><a href="#platforms-partnership">Platform’s partnership</a> (Twitch/Kick/Rumble partners, Twitch Affiliates)</td><td>20</td><td>10</td></tr><tr><td><a href="#country">Country</a> (USA, Brazil, etc.)</td><td>40</td><td>20</td></tr><tr><td><a href="#gender-channel-type">Gender</a> (male, female)</td><td>40</td><td>20</td></tr><tr><td><a href="#vtubers">VTubers</a> (list of all VTubers from Twitch and YouTube)</td><td>40</td><td>20</td></tr><tr><td><a href="#vtubers-agencies">VTubers Agencies</a> (VShojo, Hololive, NIJISANJI, etc.)</td><td>40</td><td>20</td></tr><tr><td><a href="#age">Age</a> (over 18 or 21 y.o.)</td><td>40</td><td>20</td></tr><tr><td><a href="#content-type">Content type</a> (IRL, Gaming, Slots &#x26; Casino, etc.)</td><td>40</td><td>20</td></tr><tr><td><a href="#growing-streamers">Growing streamers</a> (different types of fast-growing streamers)</td><td>40</td><td>20</td></tr><tr><td><a href="#games-streamed">Games streamed</a> (1, 2-5, 6-10, 11-25, 25+)</td><td>40</td><td>20</td></tr><tr><td><a href="#range-filters">Average Viewers range</a></td><td>40</td><td>20</td></tr><tr><td><a href="#range-filters">Peak Viewers range</a></td><td>40</td><td>20</td></tr><tr><td><a href="#range-filters">Hours Watched range</a></td><td>40</td><td>20</td></tr><tr><td><a href="#range-filters">Airtime range</a></td><td>40</td><td>20</td></tr><tr><td><a href="#range-filters">Total Followers range</a></td><td>40</td><td>20</td></tr><tr><td><a href="#range-filters">Followers Gain range</a></td><td>40</td><td>20</td></tr></tbody></table>

{% 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 %}

#### Available platforms

You can get data only for one specific platform per request. To get a list of channels, use the filter by platform: <mark style="color:yellow;">`platform={name}`</mark>. Supported values:

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

#### Supported time periods

You get a list of channels sorted by Hours Watched for the last 30 days by default. To select a different time period, use the filter <mark style="color:yellow;">`time={value}`</mark>. 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
```

#### Sorting options

You get a list of channels sorted by Hours Watched by default. If you need to get a list of channels sorted by other metrics, you should use the sorting filter: <mark style="color:yellow;">`sortBy={value}`</mark>. Supported sorting metrics:

```
peak_viewers; avg_concurrent_viewers; air_time; followers_gain
```

#### Pagination

You get 100 rows per page by default. To see other pages, use paginations, e.g. <mark style="color:yellow;">`page=2`</mark>

#### Exclude filters

Our API also supports filter exclusion mode. Use the ‘<mark style="color:yellow;">!</mark>’ sign before the filter value to do this. For example, if you want to exclude all female streamers from the Twitch channels list for the last 7 days, your request would look like this:

```
curl -X GET https://streamscharts.com/api/jazz/channels?platform=twitch&time=7-days&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)*.*

#### How to access the list of channels 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.

Use the example request below to see how it works with a list of channels with no specific filters. The TOP 100 Twitch channels for the past seven days are for free, we will not charge credits for that.

```
curl -X GET https://streamscharts.com/api/jazz/channels?platform=twitch&time=7-days \
-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": "rtainjapan",
"channel_display_name": "RTAinJapan",
"channel_id": "134850221",
"hours_watched": 3370658,
"peak_viewers": 103708,
"average_viewers": 56492,
"airtime_in_m": 3580,
"followers_gain": 13343,
"live_views": "1915224",
"last_streamed_game": "FINAL FANTASY VI",
"avatar_url": "https://static-cdn.jtvnw.net/jtv_user_pictures/rtainjapan-profile_image-056f5f8ac3ad9fae-300x300.png",
"channel_country": "JP",
"stream_language": "ja",
"partnership_status": "partner",
"channel_type": "Organization"
},
{
"platform": "twitch",
"channel_name": "eliasn97",
"channel_display_name": "eliasn97",
"channel_id": "238813810",
"hours_watched": 3010152,
"peak_viewers": 57272,
"average_viewers": 19697,
"airtime_in_m": 9170,
"followers_gain": 16716,
"live_views": "5153815",
"last_streamed_game": "Just Chatting",
"avatar_url": "https://static-cdn.jtvnw.net/jtv_user_pictures/4fb94c7a-b4c0-4ed1-9782-b630a59915d5-profile_image-300x300.png",
"channel_country": "DE",
"stream_language": "de",
"partnership_status": "partner",
"channel_type": "Male"
},
{
"platform": "twitch",
"channel_name": "tarik",
"channel_display_name": "tarik",
"channel_id": "36340781",
"hours_watched": 2726349,
"peak_viewers": 141140,
"average_viewers": 83889,
"airtime_in_m": 1950,
"followers_gain": 21648,
"live_views": "6538600",
"last_streamed_game": "VALORANT",
"avatar_url": "https://static-cdn.jtvnw.net/jtv_user_pictures/f04d2a14-8d63-4cd5-a469-7ec2cd6e5ce3-profile_image-300x300.png",
"channel_country": "US",
"stream_language": "en",
"partnership_status": "partner",
"channel_type": "Male"
},
{"platform": "twitch", "channel_name": "gaules", "channel_display_name": "Gaules", "channel_id": "181077473",…},
{"platform": "twitch", "channel_name": "gamers8gg", "channel_display_name": "Gamers8GG", "channel_id": "147084100",…},
...
{"platform": "twitch", "channel_name": "xayoo_", "channel_display_name": "Xayoo_", "channel_id": "107418731",…},
{"platform": "twitch", "channel_name": "caedrel", "channel_display_name": "Caedrel", "channel_id": "92038375",…}
],
"links":{
"first": "https://streamscharts.com/api/jazz/channels?platform=twitch&time=7-days&page=1",
"next": "https://streamscharts.com/api/jazz/channels?platform=twitch&time=7-days&page=2"
},
"meta":{
"current_page": 1,
"from": 1,
"path": "https://streamscharts.com/api/jazz/channels",
"per_page": 100,
"to": 100
},
"filters":{
"platform": "twitch",
"time": "7-days"
}
}
```

#### Excluding

NimoTV, Bigo LIVE, AfreecaTV, CHZZK, SOOP:

```
followers_gain
```

YouTube, Trovo, NimoTV, Bigo LIVE, Nonolive, AfreecaTV, Mildom:

```
live_views; partnership_status
```

Kick:

```
live_views
```

Rumble:&#x20;

```
followers_gain; live_views; last_streamed_game
```

## 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 from the world.&#x20;
{% endhint %}

To filter a list of channels by language, use the filter <mark style="color:yellow;">`lang={name}`</mark>, e.g., lang=en

Request example:

```
curl -X GET https://streamscharts.com/api/jazz/channels?platform=twitch&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)*.*

### Game/Category

To filter a list of channels by game or category, use the filter <mark style="color:yellow;">`game={name}`</mark>, e.g. game=apex-legends

Request example:

```
curl -X GET https://streamscharts.com/api/jazz/channels?platform=twitch&game=apex-legends \
-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
```

Supported platforms to filter:

```
only_partners - twitch; kick; rumble
only_affiliates - twitch
```

To filter a list of channels by platform’s partnership, use the filter <mark style="color:yellow;">`partner={value}`</mark>, e.g. partner=only\_partners

Request example:

```
curl -X GET https://streamscharts.com/api/jazz/channels?platform=twitch&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 <mark style="color:yellow;">`country={alpha‑2 code}`</mark>, e.g. country=US to get a list of channels from the USA.

Request example:

```
curl -X GET https://streamscharts.com/api/jazz/channels?platform=twitch&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 <mark style="color:yellow;">`type={value}`</mark>, e.g., type=female, to see a list of female streamers for a specific platform.

Request example:

```
curl -X GET https://streamscharts.com/api/jazz/channels?platform=twitch&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.

Supported platforms to filter:

```
twitch, youtube
```

To see a list of all VTubers by specific platform, use the filter <mark style="color:yellow;">`vtuber=all`</mark>

Request example:

```
curl -X GET https://streamscharts.com/api/jazz/channels?platform=twitch&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)*.*

### VTubers Agencies

With the help of filters in the Streams Charts database, you can select VTubers from a specific agency (affiliation) or those not represented by any agency (Independent VTubers). For the API access, we provide a filter option only for the most popular agencies of VTubers. To filter by all 200+ agencies, please use a [PRO subscription](https://streamscharts.com/pricing).

Supported values:

```
independent; vshojo; hololive; nijisanji; 774-inc
```

To filter a list of channels by VTubers agencies, use the filter <mark style="color:yellow;">`vtuber_affiliation={value}`</mark>

Request example:

```
curl -X GET https://streamscharts.com/api/jazz/channels?platform=twitch&vtuber_affiliation=vshojo \
-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)*.*

### Age

{% hint style="info" %}
Here you can get a list of streamers eligible for adult content or advertisements. Note that age information is based on user contributions and is available for hundreds of thousands of channels.
{% endhint %}

Supported values:

```
over_18; over_21
```

To filter a list of channels by gender, use the filter <mark style="color:yellow;">`age={value}`</mark>, e.g., age=over\_21

Request example:

```
curl -X GET https://streamscharts.com/api/jazz/channels?platform=twitch&age=over_21 \
-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)*.*

### Content type

Our API filters now also make it easy to find channels with specific content. For example, you can select IRL, gaming, music-related and slots-related streamers and sort them by activity in different categories of the respective platform.

Supported content type values

```
irl; gaming; esports; sports; music; slots; chess
```

To filter a list of channels by content type, use the filter <mark style="color:yellow;">`category={value}`</mark>, e.g., category=irl to get a list of channels by the specific platform from all IRL categories.

Request example:

```
curl -X GET https://streamscharts.com/api/jazz/channels?platform=twitch&category=irl \
-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)*.*

### Growing streamers

Since growth is a somewhat relative concept, we added those who stand out from the rest with their growth in followers, average concurrent viewership, and/or watch time.&#x20;

To filter a list of channels by content type, use the filter <mark style="color:yellow;">`growing_streamers={value}`</mark>

Available growing options:

* FG, Total Followers < 100K (<mark style="color:yellow;">`growing_streamers=followers_gain_100k`</mark>) - Will show growing streamers by Followers Gain metric, but only those with less than 100 thousand total followers.
* FG, Total Followers < 1M (<mark style="color:yellow;">`growing_streamers=followers_gain_1m`</mark>) - Will show growing streamers by Followers Gain metric, but only those with less than one million total followers.
* FG, growth > 100% (<mark style="color:yellow;">`growing_streamers=followers_gain_100`</mark>) - Will show growing streamers by Followers Gain metric but with an increase in this metric of more than 100% compared to the same previous period.
* FG per Hour, growth > 100% (<mark style="color:yellow;">`growing_streamers=fg_per_hour_100`</mark>) - Will show growing streamers by Followers Gain per Hour metric, but with an increase in this metric of more than 100% compared to the same previous period.
* AV, growth > 100% (<mark style="color:yellow;">`growing_streamers=avg_viewers_100`</mark>) - Will show growing streamers by Average Viewers metric but with an increase in this metric of more than 100% compared to the same previous period.
* AV, growth > 100%, gained > 1K (<mark style="color:yellow;">`growing_streamers=avg_viewers_100_1k`</mark>) - Will show growing streamers by the Average Viewers metric but with an increase in this metric of more than 100% compared to the same previous period, as well as those streamers whose Average Viewers increased by at least 1,000 people.
* HW, growth > 100% (<mark style="color:yellow;">`growing_streamers=hours_watched_100`</mark>) - Will show growing streamers by Hours Watched metric but with an increase in this metric of more than 100% compared to the same previous period.
* HW, growth > 100%, gained > 10K (<mark style="color:yellow;">`growing_streamers=hours_watched_100_10k`</mark>) - Will show growing streamers by Hours Watched metric but with an increase in this metric of more than 100% compared to the same previous period, as well as those streamers whose Hours Watched increased by at least 10,000 hours.

Request example:

```
curl -X GET https://streamscharts.com/api/jazz/channels?platform=twitch&growing_streamers=followers_gain_100k \
-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)*.*

### Games streamed

With the games streamed filter, you can get a list of true variety streamers from any specific platform. To filter a list of channels by variety, use the filter <mark style="color:yellow;">`gaming_activity={value}`</mark>. Supported values:

```
1; 2-5; 6-10; 11-25; 25-1000
```

Request example:

```
curl -X GET https://streamscharts.com/api/jazz/channels?platform=twitch&gaming_activity=25-1000 \
-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)*.*

### Range filters

If you want to focus on those channels, which have 100-1000 viewers on average or from 1 million total followers, use our additional range filters.

Supported metrics

* Hours Watched: <mark style="color:yellow;">`hw={value}-{value}`</mark>
* Average Viewers: <mark style="color:yellow;">`accv={value}-{value}`</mark>
* Peak Viewers: <mark style="color:yellow;">`pv={value}-{value}`</mark>
* Airtime: <mark style="color:yellow;">`at={value}-{value}`</mark>
* Followers Gain: <mark style="color:yellow;">`fg={value}-{value}`</mark>
* Total Followers: <mark style="color:yellow;">`followers={value}-{value}`</mark>

Request example:

```
curl -X GET https://streamscharts.com/api/jazz/channels?platform=twitch&accv=100-1000 \
-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)*.*


---

# 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-channels-by-different-metrics-and-filters.md?ask=<question>
```

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.