InsightSocial APIYouTube
YouTube API reference: 26 endpoints for channels, videos, shorts, comments, transcripts and search. Per-endpoint credit prices and cURL examples.
Channels, videos, shorts, comments, playlists, community posts, transcripts and subtitles, trending and search.
New to the API? Read the YouTube scraper API overview for what it returns and how it compares with the official API.
Base path: /v1/youtube/...
Quickstart
curl "https://api.insightsocial.app/v1/youtube/channel?handle=MrBeast" \
-H "x-api-key: $INSIGHTSOCIAL_API_KEY"Endpoints
10 of these are metered: the price depends on how much the call reads. See Credits.
7 are beta: they return the source's own structure under our naming rules (snake_case keys, string ids, ISO times where the source gives a timestamp) rather than a schema-2 entity, and their fields may change. See Schema 2.
| Endpoint | Credits | What it returns | Key parameters |
|---|---|---|---|
/channel | 10 | Returns a YouTube channel's public profile: subscriber count on author.followers (rounded above 1,000), video and view totals, description, banner and avatar URLs, and author.ext.public_email. | channelId, handle, url |
/channel/about | 250 | Returns the address behind a channel's View email address control on author.ext.public_email, its listed country, and the profile: id, handle, name, avatar, bio, URL, subscribers, join date, views. | channelId, handle, url |
/channel/videos | 10–20 | Returns recent videos published by a channel, each with title, view count, duration, thumbnail, and publish date; pass includeExtras=true to add like and comment counts. | channelId, handle |
/video | 10 | Returns full details for one video: title, view, like and comment counts, description, tags, duration, channel info, and publish date. | url |
/video/sponsors | 100 | Returns whether a video carries a paid-promotion disclosure plus the brands likely sponsoring it, each with supporting evidence and a confidence score. Beta. | url |
/video/comments | 10 | Returns comments on a video, each with the author name, comment text, like count, reply count, and publish timestamp. | url |
/video/comment/replies | 10 | Returns the replies under one comment, each with the reply text, author details, like count, and publish date. | continuationToken |
/search | 10–150 | Returns YouTube search results for a keyword: videos, channels, playlists, shorts, and live streams, each with title, thumbnail, views, and channel. | query |
/channel/shorts | 10–20 | Returns the Shorts published by a channel, each with title, view count, like count, and thumbnail. | channelId, handle |
/community-post | 10 | Returns one YouTube community post: its text, like count, comment count, attached images, and author info. | url |
/playlist | 10–110 | Returns the videos in a playlist in playlist order: video id, title, thumbnail, channel and publish date. | playlist_id |
/search/hashtag | 10–110 | Returns videos posted under a hashtag, each with view count, channel info, and publish date. | hashtag |
/shorts/trending | 50–150 | Returns the Shorts trending on YouTube right now, each with view count, like count, channel info, and thumbnail. | — |
/video/transcript | 30 | Returns the spoken transcript of a video as timestamped segments, each with text, start time and duration, plus language, word count, and speech rate. | url |
/channel/playlists | 10 | Returns the playlists on a channel's Playlists tab, each with playlist id, title, thumbnail, video count, channel info, and playlist URL. | channelId, handle |
/channel/lives | 10–70 | Returns the live and past streams on a channel's Live tab, each with title, URL, thumbnail, view count, publish time, and duration. | channelId, handle |
/channel/community-posts | 10 | Returns the posts on a channel's Posts tab, each with post id, URL, text, images, attached video, like count, publish time, and channel info. | channelId, handle |
/videos/trending | 10–60 | Returns the trending videos for a country and category, each with title, thumbnail, duration, view, like and comment counts, channel, and publish time. | — |
/playlist/items | 10–110 | Returns the videos of a playlist in playlist order, each with video id, title, thumbnail, the video's own channel, its publish date, and its position and insertion time on post.ext. | playlist_id |
/search/advanced | 10–110 | Returns video search results with the full filter set: sort order, length, live status, license, category, country, language, and publish date window. | query |
/search/suggestions | 10 | Returns the autocomplete suggestions YouTube's own search box shows for a partial query, as a plain list of strings. Beta. | query |
/video/audio | 50 | Returns the downloadable audio streams for a video, each with a direct media URL, mime type, bitrate, audio quality, sample rate, channels, and duration. Beta. | url |
/video/files | 50 | Returns the downloadable video streams for a video, each with a direct media URL, mime type, resolution, quality label, frame rate, bitrate, and duration. Beta. | url |
/video/subtitles | 10 | Returns the caption track files for a video, each with a language code and name, file format, and a direct download URL, including auto-generated tracks. Beta. | url |
/video/thumbnails | 10 | Returns a video's thumbnail images at every available size, each with a direct image URL, width, height, aspect ratio, and image format. Beta. | url |
/profile/full | 50 | Returns a channel's profile and up to 30 recent videos in one call. Beta. | handle, channelId, url |