youtube-channel
One YouTube channel as one row, from its about page: channel id, handle, title, description, subscribers (YouTube's rounded count as a number, and its shown text), video and view counts, joined date, country, links with their real targets, avatar, banner and the verified badge. channel is a channel URL (/@handle, /channel/UC…, /c/name, /user/name), a @handle or a UC… id. One plain request, about 1 second. An unknown channel gives no row.
Recipes are not open yet.
What this recipe returned on its last run. No key needed to look.
Fields
15 columns on every row. null means the site does not state it.| field | type | meaning |
|---|---|---|
| channel_id | string | The channel's id, 24 characters starting with UC. |
| handle | string | The channel's handle with its @ ("@MrBeast"); null for an old channel that has none. |
| title | string | The channel's name as YouTube shows it. |
| description | string | The channel's whole description, plain text with its line breaks. |
| subscribers | integer | The subscriber count as a number, from YouTube's rounded text ("520M" gives 520000000): YouTube shows no exact count. Null when the channel hides it. |
| subscribers_text | string | The subscriber count as YouTube shows it ("520M subscribers"); null when the channel hides it. |
| videos | integer | How many public videos the channel has, the exact number from the about panel. |
| views | integer | The channel's total views, the exact number from the about panel. |
| joined | string | The date the channel was made, ISO 8601 ("2012-02-19"). |
| country | string | The country the channel names, in English ("United States"); null when it names none. |
| links | object[] | The channel's links, a list of {title, url}; url is the real target, not YouTube's redirect link. |
| avatar | string | The URL of the channel's profile picture, the largest size the page gives (900 px). |
| banner | string | The URL of the channel's banner image, the widest size the page gives; null when the channel has no banner. |
| verified | boolean | true when the name carries YouTube's verified check mark or the official artist note; false otherwise. |
| url | string | The channel's page by id: https://www.youtube.com/channel/UC…. |
null means the site does not state it.
How it behaves
Cost. 2 units. A failed run costs 0.
Freshness 1 h. The same input within 1 h is served from cache at 0 units.
How it answers. Answers at once for one input; a large run goes as a job you poll.
Questions about this recipeQuestions
Short answers. The API reference has the long ones.
Call POST /recipes/youtube-channel with your key and channel. You get rows with the 15 fields above. The recipe is tested against the live site every 6 hours.
2 units. A failed run costs 0. The same input within 1 h costs 0.
Yes. Sign up with Google, GitHub or email for a free key with 1,000 credits every month. No credit card.
The health check runs every 6 hours against the live site. A failing recipe shows as failing on this page until we fix it.
Extra fields, higher volume, or a private copy with a freshness SLA. We build it on Enterprise.
Request a changeMore for video and creators
All 8 recipes →The latest videos of a YouTube channel, newest first: title, link, video id, when it was published, views and the thumbnail.
The videos YouTube finds for a query: title, link, video id, channel, views, when it was published (as YouTube says it, "3 years ago")…
One YouTube video's facts from its page: title, channel and channel id, length, views, likes, publish date, category, keywords and the…
For developers
Get a free API key and run your first crawl.
1,000 credits every month. No credit card. Your self-hosted setup keeps working.
For teams
Talk to us about volume, regions and an SLA.
A 30-minute call with the team that writes the crawler. DPA on request, invoice billing, your choice of US, EU or Singapore.