Skip to main content
GET
Channel videos
Cost: 1 credit per successful request. Errors and cache hits (cache_max_age) are free.
Paste this into ChatGPT, Claude or your coding assistant to generate working code for this endpoint (use the copy button).
Prompt

Authorizations

x-api-key
string
header
required

Your API key. Send it in the x-api-key header (or Authorization: Bearer <key>). Create and manage keys from your dashboard.

Query Parameters

channelId
string

The channel id: UC followed by 22 characters, e.g. UCX6OQ3DkcsbYNE6H8uQQuVA.

handle
string

The channel handle, with or without @, e.g. MrBeast.

url
string

A YouTube channel URL: /@handle, /channel/<id>, /c/<name> or /user/<name>, e.g. https://www.youtube.com/@MrBeast/videos.

sort
enum<string>
default:latest

latest (default, newest first), popular (most viewed first) or oldest. With a cursor it can be left out: the cursor keeps its sort.

Available options:
latest,
popular,
oldest
cursor
string

The cursor from the previous page, to get the next one. Omit for the first page.

cache_max_age
enum<string>

Optional. Return a cached result if one this age or newer exists — served for 0 credits with meta.cached=true and meta.cachedAt. Otherwise a fresh scrape runs (1 credit) and refreshes the cache. Omit to always scrape fresh.

Available options:
1d,
3d,
7d,
14d,
30d

Response

One page of the channel's videos.

data
object
required
meta
object
required

requestId + credit/caching metadata (creditsCharged, creditsRemaining, cached, cachedAt).