Data catalog / youtube
YouTube data
Search YouTube, read a video's details and captions, look up a channel with its subscriber count and external links, and list a channel's latest 50 videos. 1 or 2 credits per call.
In short: RichAPI has four YouTube endpoints. POST /youtube_video takes a video URL or ID and returns title, description, view and like counts, duration, tags, thumbnails and chapters, plus captions with include_captions: true, for 1 credit. POST /youtube_search takes a query and returns up to 20 videos for 1 credit. POST /youtube_channel takes a channel URL (@handle, /c/ or /channel/) and returns name, subscriber count, description, avatar, banner and external links for 1 credit. POST /youtube_channel_videos lists up to 50 of a channel's most recent videos for 2 credits.
Last updated October 6, 2026
Videos, channels and search
POST /youtube_searchtakes aqueryand returns up to 20 videos with title, channel, view count and thumbnail.POST /youtube_videotakes a video URL or ID and returns its title, description, view and like counts, duration, tags, thumbnails and chapters. Setinclude_captionstotrueto get the subtitles as well.POST /youtube_channeltakes a channel URL in any of its forms (@handle,/c/or/channel/) and returns the name, subscriber count, description, avatar, banner and the external links the channel lists.POST /youtube_channel_videoslists a channel's 50 most recent videos with titles, view counts and durations.
Endpoints and rates
| Endpoint | What it does | Credits | Billed |
|---|---|---|---|
/youtube_video |
Get full video details: title, description, view/like counts, duration, tags, thumbnails, chapters. | 1 | per call |
/youtube_search |
Search YouTube videos: returns up to 20 video IDs, titles, channels, view counts, and thumbnails per call. | 1 | per call |
/youtube_channel |
Get channel info: name, subscriber count, description, avatar, banner, external links. | 1 | per call |
/youtube_channel_videos |
List up to 50 most recent videos from a YouTube channel with titles, view counts, and durations per call. | 2 | per call |
Rates are read from the live OpenAPI spec. Credits are prepaid and never expire, and the price of a credit depends on your package: see pricing.
What YouTube data costs
1 credit per call for search, video details and channel info, and 2 credits to list a channel's videos. The rate is per call, so a search that returns 20 videos costs the same 1 credit as one that returns 3.
Finding the creators in a niche is cheap: 10 searches and 50 channel lookups cost 60 credits.
What to do with YouTube data
- Creator and sponsor lists. Search a topic, collect the channels, then read each channel's external links for a website or a business email. From the website, extract emails or check the tech stack.
- Read before you reach out. Pull a video with captions and summarise it with AI enrichment, so the first message mentions something the person said.
- Watch a competitor's channel. List its latest videos on a schedule and compare view counts over time.
YouTube limits
- Search returns at most 20 videos per call and has no page parameter. Run narrower queries to see more.
- The channel video list covers the 50 most recent uploads.
- Captions exist only where the video has them. Auto-generated captions can be rough on names and jargon.
cacheis off by default. Turn it on when re-reading the same video or channel.
Reference
| Name | Type | Required | Description |
|---|---|---|---|
url | string | Yes | YouTube video URL or video ID |
cache | boolean | No | Use cached data if available |
include_captions | boolean | No | Include video captions/subtitles in the response |
urlstring · Required- YouTube video URL or video ID
cacheboolean · Optional- Use cached data if available
include_captionsboolean · Optional- Include video captions/subtitles in the response
Request
Minimum required parameters for a youtube data call.
{
"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"include_captions": true
}See it in a workflow
Playbooks
Real patterns, recipes, and prompts other builders run on RichAPI
Developer Docs
Auth, request shape, and error handling
FAQ
