# YouTube Livestream & Channel Scraper - Videos, Likes & Stats (`tenfoldfleet/youtube-channel-scraper`) Actor

Get all videos and livestreams of a YouTube channel with exact views, likes, comment count and publish date, plus live streams and channel stats: subscribers, total views, video count, country, joined date and links. By @handle or URL, no API key. $1 per 1,000 videos; failed inputs are free.

- **URL**: https://apify.com/tenfoldfleet/youtube-channel-scraper.md
- **Developed by:** [Tenfold Fleet](https://apify.com/tenfoldfleet) (community)
- **Categories:** Videos, Agents, MCP servers
- **Features:** Limited permissions
- **Stats:** 5 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 videos

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### What does YouTube Livestream & Channel Scraper do?

**YouTube Livestream & Channel Scraper** gets **every video of a YouTube channel** from [YouTube](https://www.youtube.com) with **exact view counts, exact like counts, exact comment counts and the real publish date** (for example `2026-10-03`, not "6 days ago"). It also returns the channel's **live streams** (live now, upcoming and past) and one row of **channel stats**: subscribers, **exact total views**, exact video count, description, country, joined date, links, avatar and banner.

YouTube is a trademark of Google LLC. Not affiliated with, endorsed by or sponsored by YouTube or Google.

Give it channel **@handles**, channel URLs or channel IDs. It works like a **YouTube channel API** with no API key, no quota and no login, on plain HTTP requests (no browser). **$1 per 1,000 videos**, and channels that can't be found are **free**.

### Why use this YouTube channel scraper?

- 🎯 **Exact numbers, not rounded ones**: most channel scrapers give only a relative date like "6 days ago" and no like or comment counts. This one returns `207578319` views, `3555568` likes, `131706` comments and `2026-10-03`, so you can compute engagement rates and posting schedules.
- 📈 **Competitor and creator research**: find a channel's most popular videos (sort by Popular), how often it uploads and how its views develop.
- 🤝 **Influencer marketing**: compare subscribers, total views, likes per view and comments per view across creators before you reach out.
- 🔴 **Live stream tracking**: list upcoming streams with their scheduled time, streams that are live now with concurrent viewers, and past streams with their views.
- 🧠 **AI and data pipelines**: feed titles, full descriptions and hashtags into an LLM, a dashboard or a spreadsheet.
- 🗓️ **Monitoring**: schedule a daily run with **Published after** set to "2 days" and collect only the new uploads.

Runs on the Apify platform, so you get an **API**, scheduling, webhooks and integrations with Make, Zapier, n8n and Google Sheets. It also works as an **MCP tool for AI agents** through the [Apify MCP server](https://mcp.apify.com).

### What data can it extract?

**Video and stream rows** (`type`: `video` or `stream`):

| Field | Example |
|---|---|
| `videoId`, `url` | `plN7JMbadRg`, `https://www.youtube.com/watch?v=plN7JMbadRg` |
| `title` | `Eat Everything In A Grocery Store, Win $1,000,000` |
| `viewCount`, `viewCountText` | `207578319` (exact), `207M views` |
| `likeCount`, `commentCount` | `3555568`, `131706` (null when comments are off) |
| `publishedAt`, `publishedTimeText` | `2026-10-03`, `6 days ago` |
| `durationSec`, `durationText` | `3479`, `57:59` |
| `isLive`, `isUpcoming`, `concurrentViewers`, `scheduledStartText` | live and scheduled streams |
| `isMembersOnly` | `true` for members-only videos (YouTube hides their view count) |
| `description`, `hashtags` | full description; hashtags from title and description |
| `thumbnailUrl` | `https://i.ytimg.com/vi/plN7JMbadRg/hqdefault.jpg` |
| `channelId`, `channelName`, `channelHandle`, `channelSubscriberCountText` | `UCX6OQ3DkcsbYNE6H8uQQuVA`, `MrBeast`, `@MrBeast`, `520M subscribers` |
| `detailsFetched` | `true` when the exact numbers were loaded |

**Channel rows** (`type`: `channel`):

| Field | Example |
|---|---|
| `channelId`, `channelName`, `channelHandle`, `url` | `UCX6OQ3DkcsbYNE6H8uQQuVA`, `MrBeast`, `@MrBeast`, `https://www.youtube.com/@MrBeast` |
| `subscriberCount`, `subscriberCountText` | `520000000`, `520M subscribers` (YouTube only shows a rounded count) |
| `viewCount` | `142153736720` (exact total channel views) |
| `videoCount` | `1006` (exact) |
| `description`, `country`, `joinedDate` | full description, `United States`, `2012-02-19` |
| `links` | `[{"title": "Twitter", "url": "https://twitter.com/MrBeast"}]` (real targets, not youtube.com/redirect links) |
| `isVerified`, `avatarUrl`, `bannerUrl`, `keywords` | verified badge, images, channel keywords |

### How to scrape a YouTube channel

1. Click **Try for free**.
2. Add channels: `@MrBeast`, `https://www.youtube.com/@NASA`, `/channel/UC...`, `/c/...` or `/user/...` URLs, or channel IDs.
3. Set **Max videos per channel** (default 50) and, if you want live streams, **Max live streams per channel**.
4. Pick **Sort videos by**: Newest, Most popular or Oldest first. Optionally set **Published after** (`2026-09-01` or `30 days`).
5. Leave **Fetch exact views, likes, comments and date** on for exact numbers, or turn it off for a faster list with rounded values (same price).
6. Click **Start**, then download the results as **JSON, CSV, Excel or HTML**, or read them through the API.

#### Call it from the API

```bash
curl -X POST "https://api.apify.com/v2/acts/tenfoldfleet~youtube-channel-scraper/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"channelUrls": ["@MrBeast"], "maxVideosPerChannel": 20, "sortBy": "popular"}'
```

### How much does it cost to scrape a YouTube channel?

You pay per result: **$1 per 1,000 videos or streams** ($0.001 each) and $0.001 per channel stats row, plus a tiny $0.00005 per run start. Exact details cost the same as the quick list. A channel that doesn't exist, a channel without videos or a missing Live tab is **not charged**, and neither are videos dropped by **Published after**. Set **Max results in total** or a max cost per run and the scraper stops there.

### Input

```json
{
    "channelUrls": ["@MrBeast", "https://www.youtube.com/@NASA"],
    "maxVideosPerChannel": 50,
    "maxStreamsPerChannel": 5,
    "includeChannelInfo": true,
    "sortBy": "newest",
    "publishedAfter": "2026-09-01",
    "fetchExactDetails": true,
    "maxItems": 0
}
```

### Output

```json
{
    "type": "video",
    "videoId": "plN7JMbadRg",
    "url": "https://www.youtube.com/watch?v=plN7JMbadRg",
    "title": "Eat Everything In A Grocery Store, Win $1,000,000",
    "viewCount": 207578319,
    "viewCountText": "207M views",
    "likeCount": 3555568,
    "commentCount": 131706,
    "publishedAt": "2026-10-03",
    "publishedTimeText": "6 days ago",
    "durationSec": 3479,
    "durationText": "57:59",
    "isLive": false,
    "isUpcoming": false,
    "isMembersOnly": false,
    "concurrentViewers": null,
    "scheduledStartText": null,
    "description": "I trapped 4 strangers in an entire supermarket ...",
    "hashtags": [],
    "thumbnailUrl": "https://i.ytimg.com/vi/plN7JMbadRg/hqdefault.jpg",
    "channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA",
    "channelName": "MrBeast",
    "channelHandle": "@MrBeast",
    "channelSubscriberCountText": "520M subscribers",
    "sourceInput": "@MrBeast",
    "detailsFetched": true,
    "scrapedAt": "2026-10-10T03:37:09.112Z"
}
```

Inputs that fail come back as free rows with `input`, `reason` (`channel_not_found`, `no_videos_tab`, `no_videos`, `no_streams_tab`, `no_streams`, `invalid_input`, `blocked`) and `error`. The dataset has two views: **Videos and streams** and **Channels**. Download everything as JSON, CSV, Excel or HTML.

### Tips

- **Searching by keyword?** This scraper takes channels and channel URLs (@handles, links or IDs). To search YouTube by keyword and get the matching videos and Shorts, use our [YouTube Search Scraper](https://apify.com/tenfoldfleet/youtube-search-scraper), which takes keywords.
- **Shorts are not included.** For a channel's Shorts with views, likes and hashtags, use our [YouTube Shorts Scraper](https://apify.com/tenfoldfleet/youtube-shorts-scraper).
- For the comments of the videos you found, use our [YouTube Comments Scraper](https://apify.com/tenfoldfleet/youtube-comments-scraper); for their captions, our [YouTube Transcript Scraper](https://apify.com/tenfoldfleet/youtube-transcript-scraper).
- **Published after** is exact when exact details are on. With them off, it relies on YouTube's rounded "2 months ago" text, so it can include videos up to one week, month or year older than your date. With **Newest first** the scraper stops at the cutoff; with other orders it skips older videos but still pages through the channel.
- Set **Max videos per channel** to 0 and keep **Channel stats** on to get channel stats only, for example for a list of influencers.
- The same video found through two inputs is returned (and charged) once.
- If an exact-details lookup fails after retries, you still get the video's title, rounded views, age and duration with `detailsFetched: false`.

### Use it with AI agents (MCP)

Give Claude, ChatGPT, Cursor or any MCP client this Actor as a tool through Apify's MCP server: add `https://mcp.apify.com?tools=tenfoldfleet/youtube-channel-scraper` as a remote MCP server and sign in with your Apify account. The agent fills in the input, runs the Actor and reads the results itself; you pay the same per-event price as a normal run.

### FAQ

#### Do I need a YouTube API key or account?

No. The scraper reads public YouTube pages. No login, cookies or API quota.

#### Are the view, like and comment counts exact?

Yes, with **Fetch exact views, likes, comments and date** on (the default). Subscriber counts are always rounded, because YouTube itself only shows `520M subscribers`.

#### Can I get a channel's most popular videos?

Yes. Set **Sort videos by** to **Most popular first**. **Oldest first** gives a channel's first uploads.

#### Does it scrape live streams?

Yes. Set **Max live streams per channel** above 0 to read the channel's Live tab: streams that are live now (with concurrent viewers), upcoming streams (with their scheduled time) and past streams. Channels without a Live tab return a free `no_streams_tab` row.

#### How many videos can it get from one channel?

All of them: set **Max videos per channel** as high as you need (up to 100,000 per channel). With exact details on it saves about 3 videos per second, so 1,000 videos take about 5 minutes; for very large channels raise the run timeout (default 1 hour) or turn exact details off for a much faster list. A run that nears its timeout stops 2 minutes early and keeps everything collected so far.

### Disclaimer

This scraper collects public data only. It does not access private videos, accounts or personal data beyond what channels publish themselves. Make sure your use of the data complies with YouTube's Terms of Service and the laws that apply to you, such as GDPR.

### More tools from Tenfold Fleet

| Actor | Output |
|---|---|
| [ALDI Australia Scraper - AU Products, Unit Prices & Catalogue](https://apify.com/tenfoldfleet/aldi-australia-scraper) | product |
| [Alibaba Image Search - Reverse Lookup of Suppliers by Photo](https://apify.com/tenfoldfleet/alibaba-image-search) | matched product |
| [Wholesale Suppliers - MOQ & Price Breaks (Alibaba Alternative)](https://apify.com/tenfoldfleet/alibaba-products-scraper) | product |
| [AliExpress Reviews Scraper: Product Feedback & Photos Monitor](https://apify.com/tenfoldfleet/aliexpress-reviews-scraper) | review |
| [AliExpress Keyword Scraper - Exact Sold Counts by Search Term](https://apify.com/tenfoldfleet/aliexpress-search-scraper) | product |
| [Amazon Bestsellers Tracker: New Releases & Rank Changes](https://apify.com/tenfoldfleet/amazon-bestsellers-tracker) | ranked product |
| [Amazon Product Scraper - Details, Prices & Search by ASIN](https://apify.com/tenfoldfleet/amazon-product-scraper) | product |
| [Applicant Tracking Jobs Scraper - Greenhouse, Lever & 6 More](https://apify.com/tenfoldfleet/ats-jobs-scraper) | job posting |
| [Audio Transcription: MP3 & Video Files to Text, SRT, VTT](https://apify.com/tenfoldfleet/audio-transcription) | audio minute transcribed |
| [Backlinks Checker - Referring Domains, Anchors & Domain Rank](https://apify.com/tenfoldfleet/backlinks-checker) | backlink |
| [BBB Scraper: Business Leads, Ratings & New Reviews](https://apify.com/tenfoldfleet/bbb-scraper-leads-reviews) | business |
| [Bilibili Scraper - Videos, Comments, Danmaku & Search](https://apify.com/tenfoldfleet/bilibili-scraper) | video or comment |
| [Businesses Without Websites - Local Leads with Phone & Rating](https://apify.com/tenfoldfleet/businesses-without-websites) | lead |
| [Coles Product Scraper - Australian Supermarket Prices & Deals](https://apify.com/tenfoldfleet/coles-product-scraper) | product |
| [Company Contact Lookup - One Lead Record per Website](https://apify.com/tenfoldfleet/company-contact-finder) | website with contacts |
| [Contact Form Finder: Form Fields, Embed Type & Captcha Flag](https://apify.com/tenfoldfleet/contact-form-finder) | website with contact page or form |
| [CutShort Jobs Scraper - Startup Roles with INR Salary Ranges](https://apify.com/tenfoldfleet/cutshort-jobs-scraper) | job listing |
| [Facebook Ads Library Scraper for Marketers](https://apify.com/tenfoldfleet/facebook-ads-library-scraper) | ad |
| [Facebook Ads Transcript - Spoken Hook, CTA, Offer & Angle](https://apify.com/tenfoldfleet/facebook-ads-transcript) | video ad transcript |
| [Facebook Page Contact Finder - Business Leads from Page Links](https://apify.com/tenfoldfleet/facebook-page-contact-finder) | page with contact details |
| [Facebook Reels Scraper: Views & Captions Monitor for Any Page](https://apify.com/tenfoldfleet/facebook-reels-scraper) | reel |
| [Facebook Reels Transcript - Facebook Video to Text, No Login](https://apify.com/tenfoldfleet/facebook-reels-transcript) | reel transcript |
| [Foundit Jobs Monitor: India, Singapore & Malaysia Jobs Scraper](https://apify.com/tenfoldfleet/foundit-jobs-monitor) | job listing |
| [Funding Rounds Scraper - Recently Funded Companies & Investors](https://apify.com/tenfoldfleet/funding-rounds-scraper) | funding round |
| [Google Ads Transparency Center Scraper - Competitor Ads by Site](https://apify.com/tenfoldfleet/google-ads-transparency-scraper) | ad |
| [Google AI Overviews Checker - Citations & Domain Tracker](https://apify.com/tenfoldfleet/google-ai-overviews-checker) | keyword checked |
| [Flights API - Route & Date Fares (Google Flights Alternative)](https://apify.com/tenfoldfleet/google-flights-scraper) | route search |
| [Google Hotels Scraper - Nightly Prices, Stars & Booking Sites](https://apify.com/tenfoldfleet/google-hotels-scraper) | hotel |
| [Google for Jobs Scraper - Openings by City, Pay & Job Board](https://apify.com/tenfoldfleet/google-jobs-scraper) | job listing |
| [Google Keyword Planner Alternative - Ideas, Bids & Volume](https://apify.com/tenfoldfleet/google-keyword-planner) | keyword idea |
| [Google Maps Extractor - Business Leads, Phones & Websites](https://apify.com/tenfoldfleet/google-maps-extractor) | place |
| [Google News Scraper - Articles, Real URLs & Full Text](https://apify.com/tenfoldfleet/google-news-scraper) | article |
| [Google Travel Hotel Rate Tracker - OTA Prices for Every Night](https://apify.com/tenfoldfleet/google-travel-hotel-rate-tracker) | offer |
| [Search Trends by Region & Time - Google Trends Data Scraper](https://apify.com/tenfoldfleet/google-trends-scraper) | keyword |
| [Hirist Jobs Scraper: India Tech Jobs with New-Job Monitor](https://apify.com/tenfoldfleet/hirist-jobs-scraper) | job listing |
| [IIMJobs Jobs Scraper: Search & Monitor Management Roles](https://apify.com/tenfoldfleet/iimjobs-jobs-scraper) | job listing |
| [India Jobs Feed: Hirist, IIMJobs, Foundit, Instahyre & Cutshort](https://apify.com/tenfoldfleet/india-jobs-feed) | job listing |
| [Instagram Reels Analytics - Profile Reel Plays, Likes, Comments](https://apify.com/tenfoldfleet/instagram-reels-analytics) | reel |
| [Instagram Reels Search - Keyword to Top Reels, Plays & Creators](https://apify.com/tenfoldfleet/instagram-reels-search) | reel |
| [Instagram Reels Transcript - Speech to Text for Public Reels](https://apify.com/tenfoldfleet/instagram-reels-transcript) | reel transcript |
| [Instahyre Jobs Monitor: New Tech Jobs in India by Skill](https://apify.com/tenfoldfleet/instahyre-jobs-monitor) | job listing |
| [Keyword Ideas & Related Keywords - Difficulty, Volume & CPC](https://apify.com/tenfoldfleet/keyword-ideas) | keyword idea |
| [Keyword Search Volume, CPC & Difficulty Checker (Bulk)](https://apify.com/tenfoldfleet/keyword-search-volume) | keyword with data |
| [Likee Scraper - Creators by Country, Video Views & Likes](https://apify.com/tenfoldfleet/likee-scraper) | video |
| [LinkedIn Ads Library Scraper - Competitor Ad Copy & Targeting](https://apify.com/tenfoldfleet/linkedin-ad-library-scraper) | ad |
| [LinkedIn Company Posts Monitor: New Posts, No Login](https://apify.com/tenfoldfleet/linkedin-company-posts-monitor) | post |
| [LinkedIn Company Scraper: Firmographics & Recent Posts](https://apify.com/tenfoldfleet/linkedin-company-scraper) | company |
| [Naver Shopping Scraper - Keyword Rank, Prices, Ads & Malls](https://apify.com/tenfoldfleet/naver-shopping-scraper) | product |
| [Pinterest Search Scraper: Pins, Promoted Ads & Shop Trends](https://apify.com/tenfoldfleet/pinterest-search-scraper) | pin |
| [Podcast Transcription: Episodes to Text, SRT & Monitor](https://apify.com/tenfoldfleet/podcast-transcription) | audio minute transcribed |
| [Reddit Brand Monitoring - Keyword Alerts for Posts & Comments](https://apify.com/tenfoldfleet/reddit-brand-monitoring) | mention |
| [Reddit Post Comments Export: Threads to JSON & CSV](https://apify.com/tenfoldfleet/reddit-post-comments-export) | comment |
| [Remote Job Board Scraper - Remote Jobs Aggregator, 7 Sites](https://apify.com/tenfoldfleet/remote-jobs-aggregator) | unique remote job |
| [Reverse Image Search - Find Every Site Using a Photo](https://apify.com/tenfoldfleet/reverse-image-search) | image searched |
| [SEEK Jobs Scraper - Salaries & Hiring Across 8 APAC Job Boards](https://apify.com/tenfoldfleet/seek-job-scraper) | job listing |
| [Semrush API Domain Traffic: Visits, Authority Score, AI Traffic](https://apify.com/tenfoldfleet/semrush-api-domain-traffic) | domain |
| [SEO Agent - AI Keyword Research & Competitor Reports](https://apify.com/tenfoldfleet/seo-agent) | research report |
| [SEO Crawler - Technical SEO Audit Tool & On-Page Checker](https://apify.com/tenfoldfleet/seo-audit-tool) | page audit |
| [SEO Competitor Keywords - Domain Ranked Keywords & Keyword Gap](https://apify.com/tenfoldfleet/seo-competitor-keywords) | keyword |
| [Shopify Inventory Scraper - SKUs, Variants & In-Stock Status](https://apify.com/tenfoldfleet/shopify-products-scraper) | product |
| [Shopify App & Theme Detector - Store Analyzer & Contacts](https://apify.com/tenfoldfleet/shopify-store-analyzer) | shopify store |
| [Sitemap URL Extractor - All URLs from sitemap.xml & robots.txt](https://apify.com/tenfoldfleet/sitemap-url-extractor) | url |
| [Stock Photos & Videos Scraper for Pexels](https://apify.com/tenfoldfleet/stock-photos-scraper) | media item |
| [Website Built With Checker - Find Any Site's CMS & Tech Stack](https://apify.com/tenfoldfleet/tech-stack-detector) | website |
| [Telegram Keyword Search Monitor - New Mentions in Channels](https://apify.com/tenfoldfleet/telegram-keyword-search-monitor) | matching message |
| [Threads Search - Keyword & Profile Posts Scraper (No Login)](https://apify.com/tenfoldfleet/threads-search) | post |
| [TikTok Ads Library Scraper: Competitor Ads in Europe](https://apify.com/tenfoldfleet/tiktok-ads-library-scraper) | ad |
| [TikTok Transcripts - Captions or Speech to Text for Any Video](https://apify.com/tenfoldfleet/tiktok-transcripts) | video transcript |
| [Twitter Video Transcript - X Video to Text & SRT](https://apify.com/tenfoldfleet/twitter-video-transcript) | video transcript |
| [HTML to Text & URL to Markdown - LLM Ready Web Content](https://apify.com/tenfoldfleet/url-to-markdown) | page |
| [Video Transcriber - Any Link to Text, SRT & VTT (7 Platforms)](https://apify.com/tenfoldfleet/video-transcriber-any-url) | video transcribed |
| [Website Traffic Checker - Bulk Domain Traffic Estimate](https://apify.com/tenfoldfleet/website-traffic-checker) | domain with traffic data |
| [WeChat Official Account Articles - Keyword Search to Markdown](https://apify.com/tenfoldfleet/wechat-official-account-articles) | article found |
| [Weibo Scraper - Comment Threads, Hot Search Ranks & User Stats](https://apify.com/tenfoldfleet/weibo-scraper) | comment |
| [Woolworths Product Scraper - AU Shelf Prices, Specials & GTINs](https://apify.com/tenfoldfleet/woolworths-product-scraper) | product |
| [Workday Jobs Scraper - myworkdayjobs.com API with Salary](https://apify.com/tenfoldfleet/workday-jobs-scraper) | job posting |
| [Yahoo Finance Scraper - Quotes, History, Fundamentals & News](https://apify.com/tenfoldfleet/yahoo-finance-scraper) | ticker row |
| [YouTube Channel Email Scraper - Creator Contact Extractor](https://apify.com/tenfoldfleet/youtube-channel-email-scraper) | channel with email |
| [YouTube Comments Scraper - Replies, Likes & Sort by Newest](https://apify.com/tenfoldfleet/youtube-comments-scraper) | comment |
| [YouTube Search Scraper: Keyword Video & Shorts Monitor](https://apify.com/tenfoldfleet/youtube-search-scraper) | search result |
| [YouTube Shorts Analytics Scraper - Views, Likes & Hashtags](https://apify.com/tenfoldfleet/youtube-shorts-scraper) | short |
| [YouTube Captions Downloader - Transcript & Subtitles Scraper](https://apify.com/tenfoldfleet/youtube-transcript-scraper) | transcript |
| [YouTube Video Details Lookup: Views, Likes & Tags by URL](https://apify.com/tenfoldfleet/youtube-video-details-lookup) | video details |

# Actor input Schema

## `channelUrls` (type: `array`):

YouTube channels to scrape: @handles (@MrBeast), channel URLs (https://www.youtube.com/@NASA, /channel/UC..., /c/..., /user/...) or channel IDs (UC...).

## `maxVideosPerChannel` (type: `integer`):

How many videos to return from each channel's Videos tab. 0 = skip videos. Shorts are not included (see our YouTube Shorts Scraper).

## `maxStreamsPerChannel` (type: `integer`):

How many live streams (live now, upcoming and past) to return from each channel's Live tab. 0 = skip streams.

## `includeChannelInfo` (type: `boolean`):

Return one row per channel with subscribers, exact total views, exact video count, description, country, joined date, links, avatar and banner.

## `sortBy` (type: `string`):

Order in which videos and streams are taken from each channel, as on YouTube's Latest / Popular / Oldest buttons.

## `publishedAfter` (type: `string`):

Only videos and streams published on or after this date, e.g. 2026-09-01, or a period such as "30 days". With exact details on, the date is checked exactly; with them off it uses YouTube's rounded "2 months ago" text and can include videos up to one week, month or year older. Works best with Newest first, where the scraper stops at the cutoff.

## `fetchExactDetails` (type: `boolean`):

Load each video's exact view count, like count, comment count, publish date and full description. Turn off for a faster list with rounded views ("207M views") and relative dates ("6 days ago"). Same price either way.

## `maxItems` (type: `integer`):

Stop after this many results (videos, streams and channel rows) across all channels. 0 = no limit (the run's max cost still applies).

## `proxyConfiguration` (type: `object`):

Apify datacenter proxy works for YouTube. Channel pages retry through residential proxy only if the datacenter IPs are blocked, so there is no need to pick residential.

## Actor input object example

```json
{
  "channelUrls": [
    "@MrBeast",
    "https://www.youtube.com/@NASA"
  ],
  "maxVideosPerChannel": 10,
  "maxStreamsPerChannel": 5,
  "includeChannelInfo": true,
  "sortBy": "newest",
  "fetchExactDetails": true,
  "maxItems": 0,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `channels` (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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "channelUrls": [
        "@MrBeast",
        "https://www.youtube.com/@NASA"
    ],
    "maxVideosPerChannel": 10,
    "maxStreamsPerChannel": 5,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("tenfoldfleet/youtube-channel-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "channelUrls": [
        "@MrBeast",
        "https://www.youtube.com/@NASA",
    ],
    "maxVideosPerChannel": 10,
    "maxStreamsPerChannel": 5,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("tenfoldfleet/youtube-channel-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "channelUrls": [
    "@MrBeast",
    "https://www.youtube.com/@NASA"
  ],
  "maxVideosPerChannel": 10,
  "maxStreamsPerChannel": 5,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call tenfoldfleet/youtube-channel-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,tenfoldfleet/youtube-channel-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/NIrT6xgHmiXxPCJn2/builds/9DbHGbiAnVD4zq8tt/openapi.json