viewstats.com APIviewstats.com ↗
Access YouTube channel stats, search results, and top channel leaderboards via the Viewstats API. Subscriber counts, rankings, and growth data in structured JSON.
curl -X GET 'https://api.parse.bot/scraper/466820c3-e12c-426d-954d-acb9bc2f7456/search_channels?query=MrBeast' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for YouTube channels tracked by Viewstats. Returns up to 10 matching channels with basic metadata including subscriber count, view count, and handle.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search keyword (channel name or handle) |
{
"type": "object",
"fields": {
"channels": "array of channel objects with id, display_name, handle, avatar_url, country, subscriber_count, view_count, video_count",
"total_count": "integer total number of matching channels"
},
"sample": {
"data": {
"channels": [
{
"id": "X6OQ3DkcsbYNE6H8uQQuVA",
"handle": "mrbeast",
"country": "US",
"avatar_url": "https://yt3.ggpht.com/nxYrc_1_2f77DoBadyxMTmv7ZpRZapHR5jbuYe7PlPd5cIRJxtNNEYyOC0ZsxaDyJJzXrnJiuDE=s800-c-k-c0x00ffffff-no-rj",
"view_count": 113251721263,
"video_count": 948,
"display_name": "MrBeast",
"subscriber_count": 469000000
}
],
"total_count": 10
},
"status": "success"
}
}About the viewstats.com API
The Viewstats API exposes 3 endpoints for querying YouTube analytics data tracked by viewstats.com, covering channel search, per-channel statistics, and global leaderboards. get_channel_stats returns subscriber count, view count, video count, verification status, avatar and banner URLs, and global/country/category rankings for any channel by handle. get_top_channels returns up to 150 ranked channels with subscriber growth deltas, sortable by subscribers or views across weekly, monthly, or all-time intervals.
Channel Search
search_channels accepts a query string — a channel name or handle — and returns up to 10 matching channels with their id, display_name, handle, avatar_url, country, subscriber_count, view_count, and video_count, along with a total_count of all matched results. This is useful for resolving a human-readable name to a channel handle before passing it to other endpoints.
Per-Channel Statistics
get_channel_stats takes a channel handle (with or without a leading @) and returns a full stat snapshot: subscriber_count, view_count, video_count, verified boolean, country code, avatar_url, banner_url, and the YouTube id. The rankings field surfaces where a channel sits globally, within its country, and within its category — data that is otherwise unavailable from YouTube's own public APIs.
Top Channels Leaderboard
get_top_channels returns up to 150 channels from the Viewstats leaderboard. Two optional parameters control the result: sort_by accepts 'subs' or 'views', and interval accepts 'weekly', 'monthly', or 'all_time'. Each entry in the channels array includes the channel's rank position in the current list, its absolute subscriber_ranking, subscriber_count_, and associated metadata. This makes it straightforward to detect breakout channels or track movement in weekly subscriber growth.
Coverage and Freshness
Data reflects what Viewstats tracks for YouTube channels. The API does not currently expose video-level metrics, historical time-series data, or audience demographics — it is scoped to channel-level aggregates and rankings.
- Build a YouTube creator leaderboard ranked by weekly subscriber growth using
get_top_channelswithinterval: 'weekly' - Resolve a channel name to its YouTube ID and handle via
search_channelsfor downstream pipeline use - Monitor competitor channel subscriber and view counts by polling
get_channel_statson a schedule - Identify top channels by country or category using the rankings data from
get_channel_stats - Screen channels for verification status and country before adding them to an influencer database
- Compare monthly vs all-time subscriber rankings across a cohort of channels using
get_top_channels - Enrich a media analytics dashboard with banner and avatar URLs alongside live subscriber counts
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Viewstats have an official developer API?+
What ranking data does `get_channel_stats` return, and how is it broken down?+
get_channel_stats returns ranking positions at three scopes: a global rank across all tracked channels, a country rank filtered to channels sharing the same two-letter country code, and a category rank within the channel's content category. All three are returned in a single response alongside subscriber, view, and video counts.Can I retrieve historical subscriber or view count time-series data?+
get_top_channels endpoint surfaces growth deltas over weekly, monthly, or all-time windows, but raw historical series are not exposed. You can fork this API on Parse and revise it to add a historical data endpoint if viewstats.com exposes that surface.Does the leaderboard endpoint return more than 150 channels, or support pagination?+
get_top_channels returns up to 150 channels per call and does not currently support pagination or offset parameters. The 150-channel cap reflects the leaderboard data available from this source. You can fork the API on Parse and revise it to add pagination or deeper leaderboard slices if the underlying source supports them.