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.
Filter
List of channels, top 100, credits
List of channels, each next page (top 200, etc.), credits
20
10
20
10
20
10
20
10
40
20
40
20
40
20
40
20
40
20
40
20
40
20
40
20
40
20
40
20
40
20
40
20
40
20
40
20
Available platforms
You can get data only for one specific platform per request. To get a list of channels, use the filter by platform: platform={name}. Supported values:
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 time={value}. The maximum period of time per one TOP is 365 days. Supported values:
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: sortBy={value}. Supported sorting metrics:
Pagination
You get 100 rows per page by default. To see other pages, use paginations, e.g. page=2
Exclude filters
Our API also supports filter exclusion mode. Use the ‘!’ 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:
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.
The response you would get would be a JSON response that contains something like a sample response:
Excluding
NimoTV, Bigo LIVE, AfreecaTV, CHZZK, SOOP:
YouTube, Trovo, NimoTV, Bigo LIVE, Nonolive, AfreecaTV, Mildom:
Kick:
Rumble:
Filters supported values
Language
To filter a list of channels by language, use the filter lang={name}, e.g., lang=en
Request example:
Game/Category
To filter a list of channels by game or category, use the filter game={name}, e.g. game=apex-legends
Request example:
Platform’s partnership
Supported values:
Supported platforms to filter:
To filter a list of channels by platform’s partnership, use the filter partner={value}, e.g. partner=only_partners
Request example:
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:
Gender (Channel type)
Supported values:
To filter a list of channels by gender, use the filter type={value}, e.g., type=female, to see a list of female streamers for a specific platform.
Request example:
VTubers
Supported platforms to filter:
To see a list of all VTubers by specific platform, use the filter vtuber=all
Request example:
VTubers Agencies
Supported values:
To filter a list of channels by VTubers agencies, use the filter vtuber_affiliation={value}
Request example:
Age
Supported values:
To filter a list of channels by gender, use the filter age={value}, e.g., age=over_21
Request example:
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
To filter a list of channels by content type, use the filter category={value}, e.g., category=irl to get a list of channels by the specific platform from all IRL categories.
Request example:
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.
To filter a list of channels by content type, use the filter growing_streamers={value}
Available growing options:
FG, Total Followers < 100K (
growing_streamers=followers_gain_100k) - Will show growing streamers by Followers Gain metric, but only those with less than 100 thousand total followers.FG, Total Followers < 1M (
growing_streamers=followers_gain_1m) - Will show growing streamers by Followers Gain metric, but only those with less than one million total followers.FG, growth > 100% (
growing_streamers=followers_gain_100) - 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% (
growing_streamers=fg_per_hour_100) - 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% (
growing_streamers=avg_viewers_100) - 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 (
growing_streamers=avg_viewers_100_1k) - 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% (
growing_streamers=hours_watched_100) - 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 (
growing_streamers=hours_watched_100_10k) - 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:
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 gaming_activity={value}. Supported values:
Request example:
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:
hw={value}-{value}Average Viewers:
accv={value}-{value}Peak Viewers:
pv={value}-{value}Airtime:
at={value}-{value}Followers Gain:
fg={value}-{value}Total Followers:
followers={value}-{value}
Request example:
Last updated