YouTube Channel

Overview

Read one YouTube channel by channel id, handle or URL: subscribers, videos, views, country, creation date, the description, the links the channel lists (website, Instagram, TikTok) and the email addresses the creator writes into the description or the links. The public About page is read for free alongside the channel data.

When to use

Qualify a channel before outreach: size, country and contact data in one call.
Read links and email of a channel a search returned.

The business email YouTube shows only after sign-in and a captcha is not read; has_hidden_business_email tells that one exists. A handle without a channel completes with found: false and costs nothing.

Endpoint

Input

Output

Pricing

A channel found costs 3 credits. Channels are cached for 30 days and unknown handles for 7 days; the price stays the same.

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.	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.