Youtubesearch

• Search Videos — Search YouTube. Returns top videos with native metadata (title, channel, duration_s, view_count, published, thumbnail, description snippet) plus a cached executive summary when one exists. Pass `query` for a single search, or `queries` (up to 5) to batch several in ONE call/round-trip (results come back per query). Each query in the batch consumes one rate-limit unit and one credit.
• Get Video — Video metadata: title, channel, duration, views, publish date, full description, and chapters. Costs 1 credit. Requires an API key (free at youtubesearch.dev).
• Get Transcript — Timestamped transcript of a video. Transcripts come from captions, or a speech-to-text fallback when captions are disabled; a genuinely unextractable video (no captions and no available audio, age-restricted, or removed) returns a typed error saying exactly that. format=markdown gives sparse [mm:ss] paragraphs (best for LLMs); start/end select a time window in seconds; max_tokens caps the size. Costs 1 credit cached, 2 cold, 10 when speech-to-text runs. Requires an API key (free at youtubesearch
• Get Summary — The fewest-tokens way to understand a video: one narrative summary. Skim summaries first, then pull the full transcript for the videos that matter. Costs 1 credit cached, 5 cold. Requires an API key (free at youtubesearch.dev).

Schemas and invoke metadata: Directory API