# YouTube Channel Videos Scraper: Titles, Views, Dates (`santiagomv/youtube-channel-videos`) Actor

List every video of YouTube channels and playlists: title, views, upload date, duration, thumbnail and channel. Paste @handle, /channel/ or playlist links. Filter to recent uploads. No API key or login. $0.80 per 1,000 videos.

- **URL**: https://apify.com/santiagomv/youtube-channel-videos.md
- **Developed by:** [Santiago Marcos](https://apify.com/santiagomv) (community)
- **Categories:** Social media, Videos, Lead generation
- **Security:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$0.80 / 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

## YouTube Channel Videos Scraper: titles, views and upload dates

Get the list of videos of any **YouTube channel or playlist**. Paste channel or playlist links and get one row per video with:

- the **title**, **link** and **video ID**,
- **views** (as YouTube shows them, plus a number),
- the **upload date** (YouTube's "3 days ago" plus an approximate date),
- the **duration** (text and seconds) and whether it's **live**,
- the **thumbnail**,
- the **channel**: name, ID and `@handle`, and for playlists the playlist title and ID.

No YouTube API key, no Google account, no browser, no quota. The actor's event fee applies only to videos you get.

### Why this one

- **$0.80 per 1,000 videos**, proxies included.
- **Any channel link.** `youtube.com/@handle`, `/@handle/videos` or `/channel/UC…`, plus playlist links.
- **A cap per channel**, so 200 channels × 50 videos is one run with a predictable cost.
- **Cheap monitoring of new uploads.** Set "Only videos from the last N days": channels are listed newest first, so the run stops reading a channel at the first older video and only the new ones are charged.
- **No charge for failures.** Invalid, private or empty channels and playlists are listed in `FAILURES` and aren't charged a video fee.
- **Duplicates removed.** A video that appears in two of your sources is saved once.

### What you can use it for

- **Competitor and creator tracking**: what a channel publishes, how often, and which videos get views.
- **New-upload alerts**: run daily with "last 1 day" and send new videos to Slack, email or a Google Sheet.
- **Influencer research**: compare channels by recent views per video before reaching out.
- **Feeding other tools**: collect video links for transcript, comment or summary pipelines (see [YouTube Transcripts](https://apify.com/santiagomv/youtube-transcripts) and [YouTube Comments](https://apify.com/santiagomv/youtube-comments)).
- **Archives and datasets**: a full catalog of a channel or course playlist.

### Input

| Field | Example | Notes |
|---|---|---|
| Channels and playlists | `https://www.youtube.com/@GoogleDevelopers` | One per line. See below. |
| Max videos per channel or playlist | `100` | `0` = all YouTube lists, up to 10,000 per source. |
| Only videos from the last N days | `7` | `0` = no filter. |
| Sources in parallel | `3` | Up to 10. |

- **Channels**: `youtube.com/@handle`, `/@handle/videos` and `youtube.com/channel/UC…` links. The channel's **Videos** tab is used (no Shorts, live or podcast tabs), newest first. Old `/c/` and `/user/` links aren't supported; use the `@handle` link instead.
- **Playlists**: `youtube.com/playlist?list=…` links, in playlist order. The date filter skips older videos but keeps reading, because playlists aren't sorted by date.
- **Report**: `SUMMARY` in the key-value store lists, for each source, how many videos were saved and why it stopped (end of list, your cap, the date filter or the run's cost limit).

### Output

```json
{
  "videoId": "fNk_zzaMoSs",
  "url": "https://www.youtube.com/watch?v=fNk_zzaMoSs",
  "title": "Vectors | Chapter 1, Essence of linear algebra",
  "viewCount": 12000000,
  "viewCountText": "12M views",
  "publishedTimeText": "10 years ago",
  "publishedAtApprox": "2016-10-24T11:06:50.513Z",
  "durationSeconds": 592,
  "durationText": "9:52",
  "isLive": false,
  "thumbnailUrl": "https://i.ytimg.com/vi/fNk_zzaMoSs/hqdefault.jpg?...",
  "channelId": "UCYO_jab_esuFRV4b17AJtAw",
  "channelName": "3Blue1Brown",
  "channelHandle": "@3blue1brown",
  "playlistId": "PLZHQObOWTQDPD3MizzM2xVFitgF8hE_ab",
  "playlistTitle": "Essence of linear algebra",
  "position": 1,
  "source": "https://www.youtube.com/playlist?list=PLZHQObOWTQDPD3MizzM2xVFitgF8hE_ab",
  "scrapedAt": "2026-10-24T11:06:50.513Z"
}
```

`viewCount` is what YouTube shows in listings, so large numbers are rounded (`12M` → `12000000`). `publishedAtApprox` is worked out from the relative date, so it's only as precise as that text: roughly the right day for recent videos, and only the month or year for old ones. `position` is the video's place in the channel or playlist listing.

### Use it from code

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("santiagomv/youtube-channel-videos").call(run_input={
    "sources": ["https://www.youtube.com/@GoogleDevelopers", "https://www.youtube.com/@3blue1brown"],
    "newerThanDays": 7,
})
for v in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(v["channelName"], v["publishedTimeText"], v["viewCount"], v["title"])
```

More examples (Python, Node.js, cURL, n8n) are in the [code examples repository](https://github.com/SantiagoMV42/linkedin-jobs-scraper).

### Which YouTube actor do I need?

- **Just the video list** (URLs, titles, views, durations, approximate upload dates): this actor. Channels use the Videos tab only, and views and dates are rounded or approximate as YouTube lists them.
- **Captions as text**: [YouTube Transcripts](https://apify.com/santiagomv/youtube-transcripts), for videos that have captions available.
- **Comments and replies**: [YouTube Comments](https://apify.com/santiagomv/youtube-comments).

All three accept channel and playlist links directly.

### Pricing

**$0.80 per 1,000 videos** ($0.0008 each), charged as an actor event for each video returned. Looking up `@handles` and failed or empty sources aren't charged as events. Your run's maximum cost limit is always respected: the run stops when it's reached.

### FAQ

**Exact upload dates, likes or descriptions?** Channel and playlist listings only show relative dates and rounded views, so that's what you get, plus an approximate date. [YouTube Transcripts](https://apify.com/santiagomv/youtube-transcripts) also returns a video's description and keywords, but only for videos with captions available.

**Shorts and live streams?** Only the channel's Videos tab is read. Past live streams that YouTube lists there are included.

**Does it get every video of a big channel?** It reads what YouTube lists, up to 10,000 videos per source. Set a run cost limit for very large channels.

**Do I need a YouTube API key or proxies?** No.

**Is this allowed?** Read this before using it. This actor collects publicly visible video listings without logging in. Automated access may be against YouTube's Terms of Service, and YouTube may block or rate-limit the IP addresses or accounts involved. You are responsible for how you use this actor and the data, including copyright, privacy laws and YouTube's terms.

This actor is not affiliated with, endorsed by or sponsored by YouTube or Google LLC. YouTube is a trademark of Google LLC.

# Actor input Schema

## `sources` (type: `array`):

Channel URLs (youtube.com/@handle, /@handle/videos or /channel/UC…) or playlist URLs (youtube.com/playlist?list=…), one per line. Channels use their Videos tab (no Shorts or live tabs), newest first. /c/ and /user/ URLs aren't supported.

## `maxVideosPerSource` (type: `integer`):

Stop each channel or playlist after this many videos. 0 = all videos YouTube lists (up to 10,000 per source).

## `newerThanDays` (type: `integer`):

Keep only videos uploaded in the last N days, based on YouTube's relative date ("3 days ago"). Channels stop reading at the first older video, so this is cheap for monitoring new uploads. 0 = no date filter.

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

How many channels or playlists to read at the same time.

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

Apify Proxy is used by default and included in the price. Change it only if you know you need to.

## Actor input object example

```json
{
  "sources": [
    "https://www.youtube.com/@GoogleDevelopers"
  ],
  "maxVideosPerSource": 100,
  "newerThanDays": 0,
  "maxConcurrency": 3,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

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

All videos saved in this run, as a table.

## `summary` (type: `string`):

Videos saved per channel or playlist and why each one stopped.

## `failures` (type: `string`):

Invalid, private, empty or unresolvable channels and playlists. These are not 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 = {
    "sources": [
        "https://www.youtube.com/@GoogleDevelopers"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("santiagomv/youtube-channel-videos").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 = { "sources": ["https://www.youtube.com/@GoogleDevelopers"] }

# Run the Actor and wait for it to finish
run = client.actor("santiagomv/youtube-channel-videos").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 '{
  "sources": [
    "https://www.youtube.com/@GoogleDevelopers"
  ]
}' |
apify call santiagomv/youtube-channel-videos --silent --output-dataset

```

## MCP server setup

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

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/OXkqJvKOYfu76mwE0/builds/voKPDnnycEpOoAYJd/openapi.json