Search YouTube videos
Input
query optionalFree-text search query. Provide this OR channelUrl OR playlistUrl.
channelUrl optionalA channel URL — lists that channel's videos (its /videos tab), newest first. Query params you include are preserved (e.g. ?hl=fr&persist_hl=1 to force the UI locale), and a URL already pointing at /videos is used as-is.
maxResults optionalMax videos to return. Further pages are loaded until this many videos or the end of the list. Default 20.
Default: 20playlistUrl optionalA playlist URL — lists that playlist's videos, in playlist order.
Output
None
FAQ
Get YouTube video transcript
Fetch a YouTube video's caption transcript (auto-generated or uploaded) with per-segment timestamps. Returns available:false when the video has no captions in any language. Some runs fail when YouTube plays an ad before the video, roughly 1 in 3; the script already retries, so if it still fails, call it again later. The paired-extension browser is more reliable than the managed browser, where YouTube often shows a sign-in check and no transcript is returned.
Get YouTube comments
List a YouTube video's top-level comments from a watch URL or video id. Per comment: id, text, author, channelId, authorAvatar, publishedTime, likeCount, replyCount, isVerified, isCreator, pinned. Sort by 'top' (default) or 'newest' and paginate with the returned nextCursor. likeCount and replyCount are YouTube's abbreviated strings (e.g. "255k", "960"), and comments come back empty when they are disabled.
Get YouTube channel stats
Get a YouTube channel's stats and profile from a @handle, channel id (UC...) or channel URL. Returns channel_id, handle, name, description, subscribers, video_count, view_count, joined, country, channel_url, avatar, rss_url, is_family_safe, keywords and links. Subscribers is the abbreviated public figure (e.g. 4.51m becomes 4510000, approximate), while video_count and view_count are exact; joined is a display string (e.g. "1 Feb 2015") and each link's url is the display host without scheme.