YouTube Channel & Video Scraper
Pricing
from $0.01 / 1,000 results
YouTube Channel & Video Scraper
Enterprise-grade YouTube scraper that extracts 30+ data points per channel with built-in subscriber analytics, video performance metrics, and engagement calculations. Perfect for influencer marketing, competitor analysis, and content strategy research.
Pricing
from $0.01 / 1,000 results
Rating
0.0
(0)
Developer
The Howlers
Maintained by CommunityActor stats
0
Bookmarked
18
Total users
2
Monthly active users
18 days ago
Last modified
Categories
Features
Share
Scrape YouTube channels, videos, and search results. Extract subscriber counts, video stats, engagement metrics, and creator data for influencer research and competitive analysis. Built by John Rippy (https://johnrippy.link/).
Note: this actor runs in Demo Mode by default, so a run with the default input returns labeled sample data. Demo runs charge no channel or video events, but the Actor Start fee is still charged. Set demoMode to false to fetch real data.
Quick Start
Test with Demo Mode (sample data, only the Actor Start fee)
{"demoMode": true,"channelUrls": ["@MrBeast"]}
Run with real data
{"demoMode": false,"scrapeType": "channels","channelUrls": ["@MrBeast"],"searchType": "channel","includeVideos": true,"videosPerChannel": 10,"includeComments": false,"commentsPerVideo": 20,"maxResults": 50,"minSubscribers": 0,"minViews": 0,"sortBy": "subscribers"}
Exact counts for like rate and engagement rate
{"demoMode": false,"scrapeType": "channels","channelUrls": ["@MrBeast"],"videosPerChannel": 10,"exactViews": true,"youtubeApiKey": "YOUR_YOUTUBE_DATA_API_V3_KEY"}
Use either option or both. youtubeApiKey gives exact views, likes and comments for every video, so engagementRate is filled for popular videos too. exactViews needs no key and gives exact views and likes on channel video lists, so likeRate is filled. See "Exact counts" below.
What you get
- Video pages (
scrapeType: "videos"withvideoUrls): views, likes, the comment count and the length are read from the data YouTube embeds in the video page (its player data, its page data and its schema.org microdata). Views and likes come back exact, for example 6,114,588,193 views, also when YouTube withholds the video player. durationSecondsis the real length in seconds anddurationthe same as YouTube writes it (4:13 or 1:02:03). When YouTube withholds the video player (a bot check), the length, and the exact view count if the page lacked it, are read from YouTube's results page for that video. When no length can be read (for example a live stream),durationSecondsisnullanddurationis empty. It is never 0 as a stand-in.- Rounded counts are flagged. YouTube shows some counts only rounded: subscribers (85.4M), comment counts of 1,000 and up (5.4M), and view counts on a channel's video list (19M). The actor reports those as YouTube shows them (5.4M becomes 5400000), sets
countsRounded: trueon the row and lists them inroundedFields, for example["comments"]. A count read exactly is never flagged. Public pages usually show a comment count of 1,000 or more only rounded; when a page shows the exact number, the exact number is used. engagementRateis (likes + comments) / views x 100 and is computed only from exact counts. It isnullwhen views, likes or comments is missing or rounded. Without a YouTube Data API key it is usuallynullfor a video with 1,000 or more comments, because public pages usually round that count.likeRateis likes / views x 100, computed only from an exact view count and an exact like count. It does not need the comment count, so video pages have it even when YouTube rounds the comment count. It isnullwhen either count is missing or rounded, or when the creator hides likes.- Every count is a real number from the page or
null. Placeholder or out-of-range numbers are dropped, never reported, and likes arenullwhen the creator hides them. The browser runs in English whatever country the proxy exits in, and a count YouTube shows in another language's format (for example 1万 for 10,000) comes backnull, never as a wrong number. Proxy exits in the EU or the UK work too: the actor answers YouTube's cookie-consent prompt with "reject all", so it gets the real page instead of the consent page. - A video is charged only when its real view count was read. A video page that showed the video but not its view count (for example when YouTube served a bot check) comes back with
status: "partial",views: nulland a_notice, and is not charged. Search results without a view count are handled the same way. - Search results carry exact view counts and the length from the results page data. Results that load only after scrolling are read from the page text, where YouTube shows a rounded view count, and are flagged in
roundedFields. Without a YouTube Data API key, search rows havelikes,comments,likeRateandengagementRateset tonull. - Channels:
subscribersandvideoCountare the numbers YouTube shows on the channel page. Subscribers are rounded above 1,000 and flagged; the video count is exact below 1,000 (and always exact with a YouTube Data API key).totalViewsandavgViewsare the sum and average of views of the videos inrecentVideosthat showed a view count (nullwhen none did), not the channel's lifetime views, and are flagged when those view counts were rounded. A channel's video list shows a rounded view count and no likes or comments, so withoutexactViewsor a YouTube Data API key the videos'likes,comments,likeRateandengagementRatearenull, and so are the channel'savgLikes,avgComments,likeRateandengagementRate. They are never estimated. The channel'slikeRateandengagementRateare computed over the recent videos that have the exact counts they need. statsSourceon each video says where its counts came from:watch_page(the video's own page),channel_list(the channel's video list),search_results(the results page), oryoutube_api(your YouTube Data API key).- A channel or video page that could not be read comes back as a row with
status: "no_data"and a_notice, and is not charged. includeCommentsadds sample comments in demo mode only. Real runs do not collect comment text yet.- Demo mode rows carry
demo: trueand a_notice, so sample data is never mistaken for real data.
Exact counts
Logged-out YouTube pages show some counts only rounded. The comment count is the one that matters most: a video with 1,000 or more comments usually shows it as, for example, 5.4M, so engagementRate cannot be computed from the page for most popular videos. Two optional settings fill the gaps. Neither one changes the price: a video is still charged once as Video Scraped.
youtubeApiKey: your own YouTube Data API v3 key (create one in the Google Cloud console and enable the YouTube Data API v3). The actor asks the API for every video's exact view, like and comment counts, on video pages, channel video lists and search results, and computesengagementRatefrom them. It also reads a channel's exact video count. One request covers up to 50 videos and uses 1 unit of your key's daily quota (10,000 units by default), so a run of 10 channels uses about 20 units. The key is stored encrypted, is sent only to googleapis.com, and is never written to the output or the log. If the API rejects the key (invalid key, API not enabled, quota used up), the run continues with the counts read from YouTube's pages, logs why, and reports it in the run's status message and inyoutubeApi.errorin theSUMMARYrecord. A like count the API does not return means the creator hides likes; a missing comment count means comments are off.exactViews(default off): for channel video lists, the actor also reads each listed video's watch page for its exact view count, exact like count and the comment count it shows, solikeRateis filled. This is one extra page request per listed video,videosPerChannelfor each channel, made one at a time with a short pause in between. Only the page HTML is downloaded, not the video, images or scripts, but that is still about 1.5 MB per video (around 0.4 MB over the network with compression), so runs take longer and use more proxy traffic. Videos the API key already filled are skipped. If three watch pages in a row come back without data, the rest of that channel's videos keep the list's counts. It does not apply to video pages, which already read exact views and likes, or to search results, which keep the counts shown on the results page.
Input Parameters
| Parameter | Type | Default | Required | Description |
|---|---|---|---|---|
scrapeType | string | "channels" | Yes* | What to scrape from YouTube |
channelUrls | array | - | No | YouTube channel URLs, handles (@username), or channel IDs |
videoUrls | array | - | No | YouTube video URLs to scrape |
searchQueries | array | - | No | Search terms to find channels or videos |
searchType | string | "channel" | No | What to search for |
includeVideos | boolean | true | No | Scrape recent videos for each channel |
videosPerChannel | integer | 10 | No | Number of videos to scrape per channel |
includeComments | boolean | false | No | Scrape comments for videos (slower) |
commentsPerVideo | integer | 20 | No | Number of comments to scrape per video |
maxResults | integer | 50 | No | Maximum items to return |
minSubscribers | integer | 0 | No | Only return channels with at least this many subscribers |
minViews | integer | 0 | No | Only return videos with at least this many views |
uploadedAfter | string | - | No | Only include videos uploaded after this date (YYYY-MM-DD) |
sortBy | string | "subscribers" | No | How to sort results |
exactViews | boolean | false | No | Read each listed video's watch page on channel video lists for exact views and likes (one extra page request per video) |
youtubeApiKey | string | - | No | Your own YouTube Data API v3 key, for exact view, like and comment counts and engagementRate on every video. Stored encrypted |
proxyConfiguration | object | - | No | Proxy settings for bypassing restrictions |
demoMode | boolean | true | No | Return labeled sample rows instead of real data. No channel or video events are charged; the Actor Start fee still applies |
webhookUrl | string | - | No | Optional webhook URL to receive results when scraping completes |
sessionCookies | string | - | No | JSON array of cookies from Cookie-Editor browser extension. Export cookies while logged in to YouTube to bypass bot detection. |
cookieStorageKey | string | - | No | Key name to load cookies from the Cookie Manager KV store. If set and no manual sessionCookies are provided, the actor loads cookies from the named KV store automatically. Use this with the Cookie Manager actor for automated cookie rotation. |
cookieKvStoreName | string | - | No | Name or ID of the key-value store where Cookie Manager saved your cookies (Cookie Manager's default is cookie-sessions). Enter it here so this run is allowed to read it. If the store cannot be read, the run logs why and continues without cookies. |
Pricing
This actor uses pay-per-event billing:
| Event | When it is charged | Price |
|---|---|---|
| Actor start | Once when the run starts, one event per GB of memory (minimum one). At the default 2 GB of memory a run starts at $0.20 | $0.10 per GB |
| Channel Scraped | Charged for each YouTube channel profile scraped with full metrics | $0.05 |
| Video Scraped | Charged for each YouTube video extracted with engagement data | $0.003 |
| Result | Each item written to the default dataset | $0.00001 |
Demo mode charges no channel or video events, but Apify charges the Actor Start fee on every run, demo runs included ($0.20 at the default 2 GB of memory). exactViews and youtubeApiKey do not change the price: each video is charged once as Video Scraped either way.
Troubleshooting
"API error 429" or "Rate limit"
Too many requests. Wait a minute and try again, or reduce the number of items per run.
No results or empty dataset
Check the run log for error messages. Common causes:
- Invalid input format (check the examples above)
- The target data doesn't exist or is too small to track
How do I check the output format before a real run?
Enable Demo Mode in the input. This returns clearly labeled sample data (demo: true) so you can check the output format works for your workflow. A demo run charges no channel or video events, but it is not free: the Actor Start fee is charged as on every run ($0.20 at the default 2 GB of memory).
Why is engagementRate null for popular videos?
Public YouTube pages usually show the comment count rounded once it reaches 1,000 (for example 5.4M), and engagementRate is only computed from exact counts. Use likeRate, which needs only views and likes, or add your own youtubeApiKey to get exact comment counts and engagementRate.
Built by John Rippy | Actor Arsenal