YouTube
26 YouTube endpoints on one API key.
Channels, videos, shorts, comments, playlists, community posts, transcripts and subtitles, trending and search.
Base path: /v1/youtube/...
Quickstart
curl "https://api.insightsocial.app/v1/youtube/channel?handle=MrBeast" \
-H "x-api-key: $INSIGHTSOCIAL_API_KEY"Endpoints
12 of these are metered: the price depends on how much the call reads. See Credits.
| Endpoint | Credits | What it returns | Key parameters |
|---|---|---|---|
/channel | 20 | 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 | 500 | 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 | 20–40 | 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 | 20 | Returns full details for one video: title, view, like and comment counts, description, tags, duration, channel info, and publish date. | url |
/video/sponsors | 200 | Returns whether a video carries a paid-promotion disclosure plus the brands likely sponsoring it, each with supporting evidence and a confidence score. | url |
/video/comments | 20–100 | Returns comments on a video, each with the author name, comment text, like count, reply count, and publish timestamp. | url |
/video/comment/replies | 20–100 | Returns the replies under one comment, each with the reply text, author details, like count, and publish date. | continuationToken |
/search | 20–380 | Returns YouTube search results for a keyword: videos, channels, playlists, shorts, and live streams, each with title, thumbnail, views, and channel. | query |
/channel/shorts | 20–40 | Returns the Shorts published by a channel, each with title, view count, like count, and thumbnail. | channelId, handle |
/community-post | 20 | Returns one YouTube community post: its text, like count, comment count, attached images, and author info. | url |
/playlist | 20–220 | Returns the videos in a playlist in playlist order: video id, title, thumbnail, channel and publish date. | playlist_id |
/search/hashtag | 20–220 | Returns videos posted under a hashtag, each with view count, channel info, and publish date. | hashtag |
/shorts/trending | 100–300 | Returns the Shorts trending on YouTube right now, each with view count, like count, channel info, and thumbnail. | — |
/video/transcript | 60 | 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 | 20 | 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 | 20–140 | 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 | 20 | 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 | 20–120 | 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 | 20–220 | 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 | 20–220 | 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 | 20 | Returns the autocomplete suggestions YouTube's own search box shows for a partial query, as a plain list of strings. | query |
/video/audio | 100 | Returns the downloadable audio streams for a video, each with a direct media URL, mime type, bitrate, audio quality, sample rate, channels, and duration. | url |
/video/files | 100 | Returns the downloadable video streams for a video, each with a direct media URL, mime type, resolution, quality label, frame rate, bitrate, and duration. | url |
/video/subtitles | 20 | 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. | url |
/video/thumbnails | 20 | Returns a video's thumbnail images at every available size, each with a direct image URL, width, height, aspect ratio, and image format. | url |
/profile/full | 100 | Returns a channel's profile, up to 30 recent videos, and computed metrics in one call: engagement rate by views and by followers, posting cadence, top post, and format mix. | handle, channelId, url |