YouTube Channel Videos API
Recent public uploads for a channel. Use tab to switch between videos and shorts. With extra_fetch=true, each item is fetched individually to fill its exact view count, publish date and duration. Costs 1 credit per item fetched, up to the page size. Calls cost 1 credit each. A cache hit is free, and a failed or empty response is never charged.
Try it
Prefilled with the request that produced the example below. No key yet? Get a free key.
Request
GET
/v1/youtube/channel-videos| Parameter | Type | Required | Description |
|---|---|---|---|
| handle | string | yes | Handle (@mrbeast), channel id, or full URL |
| tab | videos | shorts | streams | no | defaults to videos |
| cursor | string | no | pagination.cursor from a previous response |
| extra_fetch | boolean | no | When true, fetches each item's own page to fill fields the list page leaves null. Costs 1 extra credit per page fetched, up to the page size. |
Also accepts cache_max_age (a hit costs 0 credits) and include_raw (returns the untouched upstream payload under raw).
curl
curl "$API/v1/youtube/channel-videos?handle=%40MrBeast&cache_max_age=7d" \
-H "x-api-key: $KEY"JavaScript
const query = new URLSearchParams({
handle: '@MrBeast',
cache_max_age: '7d',
});
const response = await fetch(`${API}/v1/youtube/channel-videos?${query}`, {
headers: { 'x-api-key': KEY },
});
const body = await response.json();
if (!body.success) throw new Error(body.error.code);
// 1 credit, 0 on a cache hit
console.log(body.data, body.meta.creditsCharged);Python
import os, httpx
r = httpx.get(
f"{os.environ['API']}/v1/youtube/channel-videos",
params={
"handle": "@MrBeast",
"cache_max_age": "7d",
},
headers={"x-api-key": os.environ["KEY"]},
timeout=30,
)
body = r.json()
if not body["success"]:
raise RuntimeError(body["error"]["code"])
print(body["data"], body["meta"]["creditsCharged"])Example response
Captured on , with raw removed and lists cut to two items. A live call returns current data.
response
{
"success": true,
"data": {
"items": [
{
"platform": "youtube",
"id": "RE3_PGwDwhw",
"type": "video",
"url": "https://www.youtube.com/watch?v=RE3_PGwDwhw",
"title": "Lose 150 Lbs Together, Win $250,000",
"text": null,
"authorId": "UCX6OQ3DkcsbYNE6H8uQQuVA",
"authorHandle": "MrBeast",
"authorName": "MrBeast",
"thumbnailUrl": "https://i.ytimg.com/vi/RE3_PGwDwhw/hq720_custom_1.jpg?sqp=CPS24NYG-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAOxG8Zjd0afmUBYJ-W0ETEys-b7A",
"mediaUrls": [],
"durationSeconds": 2597,
"viewCount": 110000000,
"likeCount": null,
"commentCount": null,
"shareCount": null,
"hashtags": [],
"mentions": [],
"isSponsored": null,
"publishedAt": null,
"fetchedAt": "2026-10-21T01:55:24.674Z"
},
{
"platform": "youtube",
"id": "plN7JMbadRg",
"type": "video",
"url": "https://www.youtube.com/watch?v=plN7JMbadRg",
"title": "Eat Everything In A Grocery Store, Win $1,000,000",
"text": null,
"authorId": "UCX6OQ3DkcsbYNE6H8uQQuVA",
"authorHandle": "MrBeast",
"authorName": "MrBeast",
"thumbnailUrl": "https://i.ytimg.com/vi/plN7JMbadRg/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAPjG6OeOsgIeIbEHSbdEWuctityQ",
"mediaUrls": [],
"durationSeconds": 3479,
"viewCount": 284000000,
"likeCount": null,
"commentCount": null,
"shareCount": null,
"hashtags": [],
"mentions": [],
"isSponsored": null,
"publishedAt": null,
"fetchedAt": "2026-10-21T01:55:24.675Z"
}
]
},
"pagination": {
"cursor": "eyJ0IjoiNHFtRnNnTGRDQklZVlVOWU5rOVJNMFJyWTNOaVdVNUZOa2c0ZFZGUmRWWkJHc0FJT0dkaGJrSm9jV3RDYm5Gb1FtcHhaVUpuYjJ0T2JVcHBUbXBOZUU5SFRYUk5SRUYzVFVNd2VWbFhVWGhNVkdodFRYcFZkRmxxYUd0WmFrMDBXbFJrYlU5WFZYbEZkazFHVVZkYWVsWXlkSE5PYTA1UFVXNVpkRk5yYURCTlNIQjFWMWhPYkdOVVVqVlNhazVGVFZaSk0xVnJVazVUTUdoTFl6SmtNMkpxU21walJYQnNXVEI0TWxaWGNGbFdiRnBEVlZob1NHTXhXakpQVnprMFZHcG9NbVZWU2tka1JHUkNVMWRHUzFReVduaFRlbWh6V1hwVk1tSnJiRnBYYkdScFdsaEtSbEZWZUVkWFZVVXlVekpXYjFkSFdrVlZha2w0VVd4Uk1WVXhPVU5VTTFKM1lsZFNSRmt5TVZkUFJGWk5VekU1VlUxWE5WQlVTSEJtWWxSV1ZGVkhhSEJqUkZaR1RrYzFSRXhXYUc1U00wcDJXV3hzV0ZJeE9YUk9SMDU0WVZWM2VGRnJNVEJPV0U1UldqRndkMXBWYnpSamEyTXhZa1JvUkdKRlpHcFZSM2hJVlcxT1YxVkZNREZTUlVweVVXdGtiMkpYVWtSa1JUUXlWak5LYTJKVmVIbFNiVTVOWlZSU05sbFZlR3hTV0VKVFlUTm9SbEV6VG14Vk1rcFNXRE5uZVdWRVFsTmFNRnAzV1RCR1RsSkZTbFpUTVRoNFpXdDBabEpxWkV0VmJUbFNZa2h3ZUV4VVFtdGxhMDVFWWxod1RsbDZRbk5rTVZJeFkxZGFSRkpZY0ZGV1ZVcFVWVEExZVdGRVduQlpWWEJ0WWpKa1RGcElWVEZWVm1SVlkwaENhRnA2VmxGTVZHeEtUbXRHVWxKclRuSmllbXhwVW1wT1VWb3dUbmxqUms1d1ZETmtXVkZVWkhCamJtaFlUVEowYmxsc1VsZGFNRkp5VEZkT00wNXRNVmxoYWxwTVkwWlNTV1ZXV20xUk0yUlZWMVJDVFUwd2VFZFhSV2hTV1ZkV1RsRnJUbnBPUkVWM1ZGUkdTRlpIVG5oa1JHdzBUak5qZUdOSVRsUmlWbHBHVjJ0V2VGRXljRmhpVlhCRVpXMW9UMVZXU2xsTmVrcHJZMjFyZW1SR1RYcFZiVTV3V2toU1IySldRWGxpUkZaSFRsZHdVbEZzVlRWWGJVWndZVE5TTkdWVVpIaFJNVlo1V1ZaSk1WSkVUakJUUmxwUFdqSk9ObFl3T0RKTmFsWkVWV3BrYVdSR09VbGhWVkpZVmtST05WTkdUbFJYVmpneFVrUktTbGg2U2paaFJrNHlWR3hPU0dWdWNHdE9SMXB5VmtaR2NWRXlOVzlsUlZaVVpFWndhMXB0ZUVsUmJrSlJUV3h3Y21ORk9XRmtiV3hSWkVkS2NHTldVbmRoYTFwMlVqRktjVkl6VWtkWFJrSkpUVVpGTW1JeWVHNVlNR3hRVjIxd2VWZFhVbmhYVlc4eFZFVmtiVkZYVVRCaVZVVXhURlJhZFdKVk1WWmxhMmh0V21wYWJrOUhTbGhPUlRsM1drUlNNVmxYV21wUFYxRXlZbGhzV0ZkSVNsQlhWbEl4VTJzMVJrMVdiSEJTVjBaelZsUmFkMUZXU25GUk0xSk1UVlZqZUZwRk9EUlRWVWt3V20xd1NGWkdXbFZXTWs1R1lqSTVTMVJWZEVWVlYydDZVa2R3VTFORmJ6RlJha3BtV2tkYVZFeFVSbmhQUldSc1ZETkpOVk5UTVhaT2JHeHZUMGh2ZVdKVmQzaFRWVTVDVW0xT2VGcEhlRkpXV0VrMFRXMHdNMU5zT0hkaVdFRXdZMFZzVlZvd2J6Vk5lVEZDV1dwa1VWSlhVWGRqVlZaSVdXMWtkV1JGYkZCUmJVWjVVa1pTU0ZSVmRIVmpNbk5aUWtFbE0wUWxNMFElM0QiLCJ2IjoiQ2d0eFZuRnhRMnRNT0ZRMlNTaU10LURXQmpJS0NnSkVSUklFRWdBZ0VHS3lBZ3F2QWtOMVFVSkRRVlZUYTJkRlFqaFJXblZhY2t0T2EwTkxOR3hoTkZWSVRrOUVOR042UlRsR2RGUTVlbU5LTms5UmJuRmlWV016TW1GaWNpMXFWa0ZrVTNCNFdscHlhRkpsYXpsWWVqZFFUR2cxTkhWbFVFbHJWVFF5TjFKNmNrRTRhM0puY0ZOdlEwczJjMlpEWkRsNVh6QXlVRVJYTFRkeFpHSmZiRkpIUzB0VE1sUkpPVFZ2VDJwNE5qWkhRbU10VldSbFRuaDBVRFIwZFV4U1JFMDFORjh6Y0ZwWVdUQm1ZbGxtYkdGa09VdGpjWGh4WmtOT05EVlVaRXhSWTJOd2FWcFlaRWRZUkZWelkyWlNhRU5EWjBaTmExVkNNM0Z0WkZRNGRucFRWazUyWHpkRVMyZHhWazB6YXpGSVRrNXVjemsyYjFacFVWRmZiMTkzWnpsSlZrTkxjbm94WVVodFNVUlRWMWMzVVVOU1YxSlpRVkZ6VTBSMk9ERXhlVVZLYXpWU2NVc3dNWHBNVWxsZmNsZDNSUSUzRCUzRCIsImMiOnsiYXV0aG9ySWQiOiJVQ1g2T1EzRGtjc2JZTkU2SDh1UVF1VkEiLCJhdXRob3JIYW5kbGUiOiJNckJlYXN0IiwiYXV0aG9yTmFtZSI6Ik1yQmVhc3QifX0",
"hasMore": true,
"count": 30
},
"meta": {
"platform": "youtube",
"endpoint": "youtube.channelVideos",
"creditsCharged": 1,
"cached": false,
"cacheAgeSeconds": null,
"durationMs": 240,
"requestId": "req_lesws6dgm6bb9ug1c6ae"
}
}Returns
Returns a list of Post in data.items.
Cost and behaviour
| Credits | 1 per live request, 0 on a cache hit |
| Cacheable | yes: cache_max_age accepts a cached copy |
| Batchable | yes: usable as a target in POST /v1/jobs/batch |
| Subscribable | yes: as often as every 3600 seconds, firing a webhook only on a change |
Other YouTube endpoints
- /v1/youtube/channel Channel details
- /v1/youtube/channel/community-posts Channel community posts
- /v1/youtube/channel/lives Channel live streams
- /v1/youtube/channel/playlists Channel playlists
- /v1/youtube/channel/shorts Channel shorts
- /v1/youtube/community-post Community post details
- /v1/youtube/playlist Playlist contents
- /v1/youtube/search Search videos