YouTube Channel Videos

Overview

List the uploads of a YouTube channel, one page per call: title, URL, publish time, views, length and whether it is a short or a live stream. next_cursor goes back as cursor for the next page.

When to use

Check how active a channel is before outreach.
Find the channel's most watched videos with sort: popular.

Endpoint

Input

Output

Pricing

A page with videos costs 2 credits; an unknown channel or an empty page costs nothing.

Examples

Playground

States

State	Description
`queued`	Request accepted; waiting to be picked up by a worker.
`processing`	Worker is actively running the enrichment.
`completed`	Enrichment finished and results are available in `output`.
`failed`	Enrichment failed; reason is in `error`. Credits are refunded for failures.

Errors

Error	When it happens	What to do
`invalid_input`	`channel` is not a channel id, handle or youtube.com channel URL, or `sort` is unknown.	Fix the request payload and retry.
`rate_limited`	The platform throttled the lookup. The run goes back to the queue and continues by itself.	No action.
`provider_error`	The data source returned an unexpected error. The run fails and is refunded.	Retry later; if persistent, contact support.
`503 endpoint_unavailable`	The endpoint is currently not configured. Nothing is reserved or charged.	Retry later; if persistent, contact support.