# Viewstats YouTube Analytics & Rankings Scraper (`getascraper/viewstats-scraper`) Actor Get YouTube channel analytics and global rankings from Viewstats.com. Extract exact views, subscribers, estimated revenue, and Shorts splits in 30+ flat columns. Processes in exactly 250ms per channel, saving 95% in execution cost. Works with Google Sheets. $4.99 per 1,000 results. - **URL**: https://apify.com/getascraper/viewstats-scraper.md - **Developed by:** [GetAScraper](https://apify.com/getascraper) (community) - **Categories:** Social media, Lead generation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.99 / 1,000 channel records This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Viewstats YouTube Analytics & Rankings Scraper **Get exact YouTube channel statistics, global rankings, estimated revenue, and short-form video performance splits from Viewstats.com.** Extract over 30 detailed columns in exactly 250 milliseconds per channel. Our high-efficiency scraper runs 10 times faster and saves up to 95% in platform execution costs compared to slower browser automation tools. Download results directly as an Excel, CSV, or JSON spreadsheet. No complex setups, no account logins, and no API keys are required. The first 50 results of every run are completely free, with pricing set at $4.99 per 1,000 results. --- ### Why use YouTube Analytics Scraper * **Scout creators with real metrics**: Instantly validate creator metrics, view counts, and engagement trends. Ensure your brand campaigns and influencer sponsorships achieve high returns. * **Track competitor performance**: Monitor competitor channels, upload intervals, and growth milestones to refine your own organic content strategy. * **Source high-value leads**: Find rapidly growing channels in any category to build outreach lists for creator management, agencies, or brand partnerships. * **Analyze Short-form video splits**: Extract exact Shorts versus long-form upload counts and view splits over multiple time windows to study what formats drive channel growth. * **Monitor global channel rankings**: Get official channel rankings by subscribers and total view counts globally, by country, and by category. --- ### How to use YouTube Analytics Scraper 1. **Enter channel identifiers**: Provide full YouTube or Viewstats channel URLs, for example: `https://www.viewstats.com/@mrbeast`, or simple handles, for example: `@pewdiepie`. 2. **Start the scraper**: Click the **Start** button in the Apify Console. 3. **Download your spreadsheet**: Export your collected analytics data instantly as an Excel, CSV, JSON, or HTML sheet. --- ### Input | Field | Type | Required | Description | | --- | --- | :---: | --- | | `startUrls` | array of URLs | No | Full YouTube or Viewstats channel URLs to extract, e.g. `https://www.viewstats.com/@mrbeast`. | | `handles` | array of strings | No | YouTube channel handles starting with @ or channel names, e.g. `@mrbeast`. | | `maxConcurrency` | integer | No | Maximum number of channels processed in parallel. Keep between 5 and 15 for optimal speed. | | `maxRequestRetries` | integer | No | Number of automatic retries if a channel page fails to load. | | `maxRequestsPerCrawl` | integer | No | Safety limit on the total number of channels extracted per run. | | `forceBrowserFallback` | boolean | No | Forces slow-loading visual mode. Only use if standard fast mode is blocked. | | `proxyConfiguration` | object | No | Connection settings to secure uninterrupted data collection. | --- ### Output Each row in your dataset represents one YouTube channel's comprehensive profile and performance metrics. Because the output is completely flat, it downloads cleanly into any spreadsheet program with no nested or corrupted rows. Here is a realistic example of a flattened output row: ```json { "channelHandle": "@mrbeast", "channelName": "MrBeast", "channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA", "avatarUrl": "https://yt3.ggpht.com/nxYrc_1_2f77DoBadyxMTmv7ZpRZapHR5jbuYe7PlPd5cIRJxtNNEYyOC0ZsxaDyJJzXrnJiuDE=s800-c-k-c0x00ffffff-no-rj", "bannerUrl": "https://yt3.googleusercontent.com/mHMO_eEMp0dPvh0ADwXhPXNYb_GnjSVsLI8biqF1CpxT8OPl7izhNQsDPD3JHhd5y5Mg9GrP", "country": "US", "verified": true, "videoCount": 988, "subscriberCount": 502000000, "viewCount": 129749433863, "vpv90": 110584326, "totalTests": 0, "recentTests": 0, "subscribersRank": "#1", "viewsRank": "#12", "globalSubscribersRanking": 1, "globalViewsRanking": 12, "countrySubscriberRanking": 1, "categorySubscriberRanking": 1, "shortViews": "5.6B", "shortPercent": "90%", "longViews": "618M", "longPercent": "10%", "sourceUrl": "https://www.viewstats.com/@mrbeast", "scrapedAt": "2026-06-18T19:42:51.976Z", "perf_weekly_views": 936707334, "perf_weekly_viewsDelta": -749838826, "perf_weekly_subscribers": 4000000, "perf_weekly_subscribersDelta": 1000000, "perf_weekly_estimatedRevenueLowUsd": 280916, "perf_weekly_estimatedRevenueHighUsd": 789373, "perf_weekly_estimatedRevenueDelta": -251041, "perf_monthly_views": 6180565059, "perf_monthly_viewsDelta": 1468652896, "perf_monthly_subscribers": 14000000, "perf_monthly_subscribersDelta": 5000000, "perf_monthly_estimatedRevenueLowUsd": 1648858, "perf_monthly_estimatedRevenueHighUsd": 4641675, "perf_monthly_estimatedRevenueDelta": 11896, "perf_yearly_views": 43372074195, "perf_yearly_viewsDelta": 8840034657, "perf_yearly_subscribers": 95000000, "perf_yearly_subscribersDelta": -23000000, "perf_yearly_estimatedRevenueLowUsd": 22442836, "perf_yearly_estimatedRevenueHighUsd": 62676789, "perf_yearly_estimatedRevenueDelta": -5577529, "perf_allTime_views": 129749433863, "perf_allTime_viewsDelta": 0, "perf_allTime_subscribers": 502000000, "perf_allTime_subscribersDelta": 0, "perf_allTime_estimatedRevenueLowUsd": 173151082, "perf_allTime_estimatedRevenueHighUsd": 480812407, "perf_allTime_estimatedRevenueDelta": 0, "split_weekly_views": 936707334, "split_weekly_longViews": 102928614, "split_weekly_shortViews": 833778719, "split_weekly_videos": 5, "split_weekly_shorts": 3, "split_weekly_longs": 2, "split_monthly_views": 6180565059, "split_monthly_longViews": 618047915, "split_monthly_shortViews": 5562517143, "split_monthly_videos": 10, "split_monthly_shorts": 7, "split_monthly_longs": 3, "split_ninetyDays_views": 14820778255, "split_ninetyDays_longViews": 2067543852, "split_ninetyDays_shortViews": 12753234402, "split_ninetyDays_videos": 38, "split_ninetyDays_shorts": 29, "split_ninetyDays_longs": 9, "split_yearly_views": 43972642896, "split_yearly_longViews": 8463365676, "split_yearly_shortViews": 35509277219, "split_yearly_videos": 120, "split_yearly_shorts": 90, "split_yearly_longs": 30, "split_allTime_views": 129749433863, "split_allTime_longViews": 53635106984, "split_allTime_shortViews": 76114326878, "split_allTime_videos": 1008, "split_allTime_shorts": 196, "split_allTime_longs": 812 } ```` *** ### Data table | Field | Type | Description | | --- | :---: | --- | | `channelHandle` | string | The YouTube handle beginning with @. | | `channelName` | string | The display name as shown on YouTube. | | `channelId` | string | Unique 24-character YouTube Channel ID starting with UC. | | `avatarUrl` | string | URL of the channel avatar. | | `bannerUrl` | string | URL of the channel banner. | | `country` | string | Two-letter ISO country code. | | `verified` | boolean | True if verified by YouTube. | | `videoCount` | integer | Total uploaded video count. | | `subscriberCount` | integer | Real-time subscriber count. | | `viewCount` | integer | Total accumulated channel view count. | | `vpv90` | integer | Average views per video over the last 90 days. | | `subscribersRank` | string | Global ranking by subscribers, compact string format. | | `viewsRank` | string | Global ranking by views, compact string format. | | `globalSubscribersRanking` | integer | Global ranking by subscribers, integer format. | | `globalViewsRanking` | integer | Global ranking by views, integer format. | | `countrySubscriberRanking` | integer | Subscribers ranking within the channel country. | | `categorySubscriberRanking` | integer | Subscribers ranking within the channel category. | | `shortViews` | string | Total views on Shorts over the last 28 days. | | `shortPercent` | string | Share of monthly views from Shorts. | | `longViews` | string | Total views on long-form videos over the last 28 days. | | `longPercent` | string | Share of monthly views from long-form videos. | | `perf_[period]_views` | integer | Gained views in the selected window (weekly, monthly, quarterly, yearly, allTime). | | `perf_[period]_viewsDelta` | integer | Gained views change versus the previous equivalent window. | | `perf_[period]_subscribers` | integer | Gained subscribers in the selected window. | | `perf_[period]_estimatedRevenueLowUsd` | integer | Low-end estimated revenue in USD for this window. | | `perf_[period]_estimatedRevenueHighUsd` | integer | High-end estimated revenue in USD for this window. | | `split_[period]_videos` | integer | Total uploads in this window. | | `split_[period]_shorts` | integer | Shorts uploaded in this window. | | `split_[period]_longs` | integer | Long-form videos uploaded in this window. | | `split_[period]_longViews` | integer | Long-form views in this window. | | `split_[period]_shortViews` | integer | Shorts views in this window. | | `sourceUrl` | string | The Viewstats profile URL. | | `scrapedAt` | string | ISO timestamp of the extraction. | *** ### Pricing **$4.99 per 1,000 channels. The first 50 results of every run are completely free.** No monthly subscriptions and no minimum commits. Our advanced, light-weight client does not require slow browser automation to process your requests. It downloads data directly from the server, running in exactly 250 milliseconds per channel. This keeps platform compute costs near zero, meaning you only pay for the results you retrieve. *** ### Tips and optimization - **Scrape in bulk**: You can paste up to 1,000 handles or URLs in a single run. The scraper processes them in parallel for maximum speed. - **Integrate with Google Sheets**: Set up an Apify integration to automatically sync your scraped results into a Google Sheet, Zapier, or Make scenario. - **Schedule daily runs**: Set up a schedule to automatically scrape your competitor channels every day or week. Track their estimated revenue growth and format shifts over time. *** ### FAQ **Is scraping Viewstats legal?** This scraper retrieves publicly visible data that anyone can see without logging in. You are responsible for ensuring your use case complies with applicable laws and standard crawling guidelines. **How is the revenue estimated?** Estimated revenue represents standard YouTube advertiser payouts calculated using standard regional CPM variations. The low and high bounds are derived from regional benchmarks and are best-effort projections. **What is the advantage of flat output?** Flat datasets are perfectly formatted for spreadsheet software like Excel and Google Sheets. You can perform calculations, filter by country, or sort by subscribers immediately without any manual data cleaning. **Why is this scraper so much cheaper than others?** Most scrapers load the full visual page in a real browser. We bypass browser loading, reading data directly from the server, which runs 10 times faster, consumes 16 times less memory, and reduces execution costs by 95%. *** ### Disclaimers and support - **Disclaimer**: This is an independent scraper that retrieves publicly available information. It is not affiliated with, endorsed by, or sponsored by Viewstats, YouTube, or Google. - **Support**: For any bug reports, feature requests, or custom field additions, please open a ticket under the **Issues** tab! # Actor input Schema ## `startUrls` (type: `array`): Full YouTube or Viewstats channel URLs to extract, e.g. https://www.viewstats.com/@mrbeast. ## `handles` (type: `array`): YouTube channel handles (starting with @) or names, e.g. @mrbeast, @pewdiepie. ## `maxConcurrency` (type: `integer`): Maximum number of channels processed in parallel. Keep between 5 and 15 for optimal loading speed. ## `maxRequestRetries` (type: `integer`): Number of automatic retries if a channel fails to load. ## `maxRequestsPerCrawl` (type: `integer`): Safety limit on the total number of channels extracted per run. ## `forceBrowserFallback` (type: `boolean`): Forces the scraper to render the page visually. This is much slower and should only be used if standard fast extraction is blocked. ## `proxyConfiguration` (type: `object`): Connection settings to secure uninterrupted data collection. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.viewstats.com/@mrbeast" } ], "handles": [ "@mrbeast" ], "maxConcurrency": 10, "maxRequestRetries": 3, "maxRequestsPerCrawl": 100000, "forceBrowserFallback": false, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `dataset` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ { "url": "https://www.viewstats.com/@mrbeast" } ], "handles": [ "@mrbeast" ], "maxConcurrency": 10, "maxRequestRetries": 3, "maxRequestsPerCrawl": 100000, "forceBrowserFallback": false, "proxyConfiguration": { "useApifyProxy": false } }; // Run the Actor and wait for it to finish const run = await client.actor("getascraper/viewstats-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": [{ "url": "https://www.viewstats.com/@mrbeast" }], "handles": ["@mrbeast"], "maxConcurrency": 10, "maxRequestRetries": 3, "maxRequestsPerCrawl": 100000, "forceBrowserFallback": False, "proxyConfiguration": { "useApifyProxy": False }, } # Run the Actor and wait for it to finish run = client.actor("getascraper/viewstats-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ { "url": "https://www.viewstats.com/@mrbeast" } ], "handles": [ "@mrbeast" ], "maxConcurrency": 10, "maxRequestRetries": 3, "maxRequestsPerCrawl": 100000, "forceBrowserFallback": false, "proxyConfiguration": { "useApifyProxy": false } }' | apify call getascraper/viewstats-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=getascraper/viewstats-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Viewstats YouTube Analytics & Rankings Scraper", "description": "Get YouTube channel analytics and global rankings from Viewstats.com. Extract exact views, subscribers, estimated revenue, and Shorts splits in 30+ flat columns. Processes in exactly 250ms per channel, saving 95% in execution cost. Works with Google Sheets. $4.99 per 1,000 results.", "version": "0.2", "x-build-id": "EMOP95lx3YONGpin0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~viewstats-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-viewstats-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/getascraper~viewstats-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-viewstats-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/getascraper~viewstats-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-viewstats-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "startUrls": { "title": "Start URLs", "type": "array", "description": "Full YouTube or Viewstats channel URLs to extract, e.g. https://www.viewstats.com/@mrbeast.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "handles": { "title": "Channel Handles", "type": "array", "description": "YouTube channel handles (starting with @) or names, e.g. @mrbeast, @pewdiepie.", "default": [] }, "maxConcurrency": { "title": "Max Concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum number of channels processed in parallel. Keep between 5 and 15 for optimal loading speed.", "default": 10 }, "maxRequestRetries": { "title": "Max Retries", "minimum": 0, "type": "integer", "description": "Number of automatic retries if a channel fails to load.", "default": 3 }, "maxRequestsPerCrawl": { "title": "Max Channels per Run", "minimum": 1, "type": "integer", "description": "Safety limit on the total number of channels extracted per run.", "default": 100000 }, "forceBrowserFallback": { "title": "Force Visual Mode", "type": "boolean", "description": "Forces the scraper to render the page visually. This is much slower and should only be used if standard fast extraction is blocked.", "default": false }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Connection settings to secure uninterrupted data collection.", "default": { "useApifyProxy": false } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```