YouTube Channel Search

Overview

Find the YouTube channels behind a search term, one page per call: channel results and the uploaders of video results, each channel once, with the video that brought it in. Subscriber counts are set where the search shows them. next_page goes back as page for more.

When to use

See which channels own a topic before you qualify them with youtube_channel.
Collect candidates by hand; youtube_find_leads does the paging, the subscriber filter and the channel lookups for you.

Endpoint

Input

Output

Pricing

A page with channels costs 2 credits, a page without any 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`	`query` is missing, or `gl`/`hl` is not a two-letter code.	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.