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_search takes a query and returns up to 20 videos with title, channel, view count and thumbnail.
  • POST /youtube_video takes a video URL or ID and returns its title, description, view and like counts, duration, tags, thumbnails and chapters. Set include_captions to true to get the subtitles as well.
  • POST /youtube_channel takes 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_videos lists 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.
  • cache is off by default. Turn it on when re-reading the same video or channel.

Reference

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.

Request
{
  "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

Start free with 100 credits

Developer Docs

Auth, request shape, and error handling

See Documentation

FAQ

Frequently asked questions

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.
Every endpoint is billed from the same credit pool, at the published rate on /pricing — never a separate contract per endpoint.
Yes — the same endpoint is reachable from an MCP client (Claude, ChatGPT, Cursor, Windsurf) using the same key and credit pool. See /mcp.

Related data