# YouTube Channel Videos & Shorts Scraper (`heyitsgautham/youtube-channel-videos-scraper`) Actor

Every video, Short and live stream of YouTube channels, one flat row each, with exact publish time, duration, views, likes, comments, tags and channel stats. Newest, popular or oldest, date window, only-new mode. Handles, URLs or IDs. $0.50 per 1,000.

- **URL**: https://apify.com/heyitsgautham/youtube-channel-videos-scraper.md
- **Developed by:** [Gautham Krishna](https://apify.com/heyitsgautham) (community)
- **Categories:** Videos, Social media
- **Features:** Limited permissions
- **Stats:** 11 total users, 11 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.25 / 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.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## YouTube Channel Videos & Shorts Scraper

Get every video, Short and live stream of any YouTube channel as one flat row each, with the exact publish time, duration, views, likes, comments, tags and channel stats.

Give it @handles, channel URLs, `UC...` channel IDs or even a video link, and choose how many videos, Shorts and live streams you want from each channel.
Order them newest first, most viewed first or oldest first, keep only a date window, or schedule it to return only uploads that are new since the last run.

You pay **$0.50 per 1,000 videos** ($0.0005 each), and less on Apify Store discount tiers, down to $0.25 per 1,000 on Gold.
Channels that don't exist, invalid input, empty channels and videos that fail are **never charged**.
In the final test run, all 67 real channels returned videos, 1,379 rows in 158 seconds.
They ranged from 12 to 526 million subscribers, and included Shorts-only channels, live news and gaming channels, and channels in Hindi, Spanish, French, German, Portuguese, Russian, Japanese, Korean, Indonesian and Arabic.
They were given as handles, bare handles, channel URLs, `UC...` IDs and video links.
Another run returned all 1,731 regular videos of @mkbhd, back to 2008, in 6 minutes.

### Is it reliable?

This actor went public on 11 November 2026, so the run success figure in its Store stats counts almost no public runs yet.
Our test runs on Apify measured this.

| Test | Result |
|---|---|
| 69 inputs: 67 real channels, 1 made-up handle, 1 non-YouTube link | 67 of 67 channels returned videos, 1,379 rows. The 2 bad inputs got free rows saying why |
| Every regular video of @mkbhd | 1,731 of 1,731, back to 2008 |
| Only new since the last run, 10 channels run twice | Second run returned 0 repeats and nothing older |
| Date window 1 to 31 October 2026 on 5 channels | 106 rows, all published inside the window |

Each request that fails is retried on a fresh residential IP, up to 5 times.

### Why this one

- **Shorts are labelled by YouTube, not guessed.**
  Each row's `type` is `video`, `short` or `stream`, after the channel tab it is listed on.
  Shorts run up to 3 minutes, and the longest in our tests was 180 seconds, so a 60-second cutoff mislabels them.
  In the final test run, 194 of 576 Shorts were longer than 60 seconds, and 13 of 632 regular videos were 60 seconds or shorter.
- **Exact numbers.**
  `publishedAt` is the exact publish time in UTC, never "3 weeks ago".
  `viewCount`, `likeCount` and `commentCount` are exact counts, never "1.2M".
- **Live streams included.**
  Past, current and scheduled streams come from the Live tab, with `liveStatus` and the real start and end times.
- **YouTube's own sort buttons.**
  Newest, Popular and Oldest use the Latest, Popular and Oldest buttons on each channel tab.
  So "most viewed" gives the channel's real top videos of all time, not the top of its latest 50.
- **No API key and no quota.**
  There is no daily limit to run into.
  You can ask for up to 20,000 of each type per channel.
- **One flat row per video.**
  Every row also carries the channel's name, handle, subscribers, video count, total views, join date and country, ready for a spreadsheet.

### What people use it for

- Track competitor channels every week and get only their new uploads, with views and likes.
- Compare Shorts against long-form videos on the same channels, by views, likes and comments per video.
- Vet creators before a sponsorship by their upload rate, recent views and engagement.
- Build a list of video IDs to feed into transcript or comment scrapers.

### Input

```json
{
  "channels": ["@mkbhd", "https://www.youtube.com/@LofiGirl/videos", "UCHnyfMqiRRG1u-2MsSQLbXA"],
  "maxVideos": 50,
  "maxShorts": 50,
  "maxStreams": 10,
  "sortBy": "newest",
  "publishedAfter": "30 days"
}
```

| Option | What it does |
|---|---|
| `channels` | One channel per line. `@handle`, a bare handle such as `mkbhd`, any channel URL (`/@name`, `/channel/UC...`, `/c/...`, `/user/...`, with or without `/videos`), a `UC...` channel ID, or a video, Shorts or youtu.be link, which stands for the channel that uploaded it |
| `maxVideos`, `maxShorts`, `maxStreams` | How many regular videos, Shorts and live streams to take from each channel. Default 50 each. `0` skips that type, `20000` takes all of them |
| `sortBy` | `newest` (default), `popular` or `oldest` |
| `publishedAfter`, `publishedBefore` | A date window on each video's exact publish time. A date such as `2026-10-01`, an ISO time, or a relative value such as `7 days` |
| `onlyNewSinceLastRun` | For scheduled runs. Returns only videos not returned by an earlier run, per channel and type |
| `maxConcurrency`, `useProxy` | Advanced. Leave the residential proxy on, since YouTube blocks cloud IPs |

AI agents and API callers can send only `channels`, and get up to 50 of each type per channel, newest first.

### What you get per video

| Field | What it holds |
|---|---|
| `type` | `video`, `short` or `stream`, from the channel tab it is listed on |
| `position` | Its place in that tab in the chosen order, starting at 1 |
| `videoId`, `url`, `title` | Shorts get a `/shorts/` URL |
| `publishedAt` | Exact publish time in UTC, such as `2026-10-27T20:14:55Z` |
| `durationSeconds`, `duration` | Such as `90` and `1:30`. `null` while a stream is live or scheduled |
| `viewCount`, `likeCount`, `commentCount` | Exact counts. `likeCount` is `null` when the creator hides likes, `commentCount` when comments are off |
| `category`, `tags`, `hashtags` | The YouTube category, the uploader's tags, and the hashtags in the title and description |
| `description`, `descriptionLinks` | The full description and every link in it. Emails and phone numbers are replaced with `[email removed]` and `[phone removed]` |
| `thumbnailUrl` | The largest thumbnail |
| `liveStatus`, `liveStartTime`, `liveEndTime` | `was_live`, `live_now` or `upcoming` for streams, with start and end times. `null` on normal uploads |
| `isFamilySafe` | YouTube's family-safe flag |
| `channelName`, `channelId`, `channelHandle`, `channelUrl`, `channelAvatarUrl` | The channel |
| `channelSubscriberCount`, `channelVideoCount`, `channelViewCount`, `channelJoinedDate`, `channelCountry` | Channel stats from its about panel. Subscribers are as rounded as YouTube shows them, such as 21,400,000 |
| `input`, `scrapedAt` | The input line this row came from, and when it was read |
| `status` | `ok` on every charged row |

### Output example

A real row from a test run, for a Short of 1 minute 41 seconds.

```json
{
  "status": "ok",
  "type": "short",
  "position": 8,
  "videoId": "IHkp5Kq72ro",
  "url": "https://www.youtube.com/shorts/IHkp5Kq72ro",
  "title": "How Dangerous Are Non-Stick Pans?",
  "publishedAt": "2026-10-01T18:26:42Z",
  "durationSeconds": 101,
  "duration": "1:41",
  "viewCount": 1724300,
  "likeCount": 49586,
  "commentCount": 1047,
  "category": "Education",
  "description": "What happens to your body if you eat Teflon from a non-stick pan?\n\n#pfas \n#foreverchemicals",
  "hashtags": [
    "#pfas",
    "#foreverchemicals"
  ],
  "tags": [
    "veritasium",
    "science",
    "physics",
    "pfas"
  ],
  "descriptionLinks": [],
  "thumbnailUrl": "https://i.ytimg.com/vi/IHkp5Kq72ro/maxresdefault.jpg",
  "liveStatus": null,
  "liveStartTime": null,
  "liveEndTime": null,
  "isFamilySafe": true,
  "channelName": "Veritasium",
  "channelId": "UCHnyfMqiRRG1u-2MsSQLbXA",
  "channelHandle": "@veritasium",
  "channelUrl": "https://www.youtube.com/@veritasium",
  "channelAvatarUrl": "https://yt3.googleusercontent.com/7vCbvtCqtjQ3YLgsJt7Y952MQV1sBvhllSCSxHP8_sVZdcPCBrITfhkN2RdyCuwPnsByq-1GoA=s900-c-k-c0x00ffffff-no-rj",
  "channelSubscriberCount": 21400000,
  "channelVideoCount": 548,
  "channelViewCount": 4745916240,
  "channelJoinedDate": "2010-07-21",
  "channelCountry": "United States",
  "input": "UCHnyfMqiRRG1u-2MsSQLbXA",
  "scrapedAt": "2026-11-11T08:37:39Z"
}
```

A past live stream from the same run, trimmed to the fields that matter for streams.

```json
{
  "type": "stream",
  "position": 3,
  "videoId": "0GRsPTEG7Sk",
  "url": "https://www.youtube.com/watch?v=0GRsPTEG7Sk",
  "title": "Brb,  The Army",
  "publishedAt": "2021-06-20T16:01:42Z",
  "durationSeconds": 8121,
  "duration": "2:15:21",
  "viewCount": 1574433,
  "likeCount": 56253,
  "commentCount": 1161,
  "liveStatus": "was_live",
  "liveStartTime": "2021-06-20T12:42:08Z",
  "liveEndTime": "2021-06-20T14:57:41Z",
  "channelName": "PewDiePie",
  "channelHandle": "@PewDiePie"
}
```

### Rows that are free

Every input gets at least one row, so you can see what happened to it.

| `status` | When |
|---|---|
| `invalid_input` | The line is not a YouTube channel, for example a playlist or another site |
| `not_found` | No channel has this handle or ID, or the channel was terminated |
| `no_videos` | The channel has none of the requested types, or none in the date window, or none new since the last run. `message` says which |
| `duplicate` | Two input lines point to the same channel, so its videos are returned once |
| `error` | YouTube did not answer after 5 tries on fresh IPs |

### Monitoring new uploads

Schedule a run with `onlyNewSinceLastRun` on and the default newest-first order.
The first run returns the usual results and remembers them.
Each later run returns only videos it has not returned before, and nothing older than the newest one it returned last time, so you pay only for new uploads.
The memory is a key-value store named `youtube-channel-videos-scraper-monitor` in your own Apify account, kept separately per channel and per type.

### What it costs

| Job | Rows | Cost |
|---|---|---|
| Latest 50 videos of 1 channel | 50 | $0.025 |
| 50 videos, 50 Shorts and 50 streams of 10 channels | up to 1,500 | up to $0.75 |
| Every video of a channel with 2,000 uploads | 2,000 | $1.00 |

The Apify Free plan's $5 monthly credit covers about 10,000 videos.

### FAQ

**Do I need a YouTube API key?**
No.
The actor reads the same public data youtube.com shows a logged-out visitor, so there is no key and no daily quota.

**Why is `commentCount` sometimes `null`?**
Usually the channel turned comments off for that video, which NASA does on most of its uploads.

**Can I get only Shorts?**
Yes.
Set `maxVideos` and `maxStreams` to `0`.

**Does it download videos or read transcripts?**
No.
For transcripts of a whole channel, use [YouTube Channel & Playlist Transcripts](https://apify.com/heyitsgautham/youtube-channel-transcripts).
For comments, use [YouTube Comments Scraper](https://apify.com/heyitsgautham/youtube-comments-scraper).

**Is it legal?**
It reads only public videos and public channel pages, with no login.
It returns no emails or phone numbers, and removes them from descriptions.
Check that your own use of the data follows the laws that apply to you.

### Usage counting

Each run counts only how it started (API, schedule, web or an integration) and the kind of client that started it. It never records who runs it, their IP or their input.

# Actor input Schema

## `channels` (type: `array`):

YouTube channels, one per line. Accepts @handles, bare handles such as mkbhd, channel URLs (/@name, /channel/UC..., /c/..., /user/..., with or without /videos), UC... channel IDs, and video or Shorts links, which stand for the channel that uploaded them.

## `maxVideos` (type: `integer`):

Regular videos from each channel's Videos tab. 0 skips them. 20000 takes every one.

## `maxShorts` (type: `integer`):

Shorts from each channel's Shorts tab. 0 skips them. 20000 takes every one.

## `maxStreams` (type: `integer`):

Past, current and scheduled live streams from each channel's Live tab. 0 skips them. 20000 takes every one.

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

Which videos come first, using the Latest, Popular and Oldest buttons on the channel's own tabs. The limits above take the first ones in this order.

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

Only videos published on or after this time. Use a date such as 2026-10-01, an ISO time such as 2026-10-01T12:00:00Z (UTC), or a relative value such as 7 days, meaning the last 7 days. Uses each video's exact publish time. With newest first, reading stops once a channel's videos are older.

## `publishedBefore` (type: `string`):

Only videos published before this time. Same formats as Published after. Combine both for a window, such as 2026-01-01 to 2026-04-01.

## `onlyNewSinceLastRun` (type: `boolean`):

For scheduled runs. Returns only videos this actor has not returned before for the same channel and type, and nothing older than the newest one it returned last time. The first run returns the usual results and remembers them. The memory is a key-value store named youtube-channel-videos-scraper-monitor in your Apify account. Use it with Newest first.

## `maxConcurrency` (type: `integer`):

How many requests to YouTube run at once.

## `useProxy` (type: `boolean`):

Leave on. YouTube blocks cloud IPs.

## Actor input object example

```json
{
  "channels": [
    "https://www.youtube.com/@NASA"
  ],
  "maxVideos": 5,
  "maxShorts": 5,
  "maxStreams": 5,
  "sortBy": "newest",
  "onlyNewSinceLastRun": false,
  "maxConcurrency": 20,
  "useProxy": true
}
```

# Actor output Schema

## `videos` (type: `string`):

One row per video, Short or live stream with its type, exact publish time, duration, views, likes, comments, description, tags and channel stats. Inputs that fail get one free row with the reason. Only rows with status ok are charged.

# 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 = {
    "channels": [
        "https://www.youtube.com/@NASA"
    ],
    "maxVideos": 5,
    "maxShorts": 5,
    "maxStreams": 5
};

// Run the Actor and wait for it to finish
const run = await client.actor("heyitsgautham/youtube-channel-videos-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 = {
    "channels": ["https://www.youtube.com/@NASA"],
    "maxVideos": 5,
    "maxShorts": 5,
    "maxStreams": 5,
}

# Run the Actor and wait for it to finish
run = client.actor("heyitsgautham/youtube-channel-videos-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 '{
  "channels": [
    "https://www.youtube.com/@NASA"
  ],
  "maxVideos": 5,
  "maxShorts": 5,
  "maxStreams": 5
}' |
apify call heyitsgautham/youtube-channel-videos-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,heyitsgautham/youtube-channel-videos-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/czbUsQx0f7TKmh63A/builds/bBnP0y2oXZtyc6rZm/openapi.json
