Skip to content
Try for free
On this page

Integrations

YouTube

Interact with YouTube videos, channels, and playlists

Use YouTube to search videos, retrieve video details and comments, and list channel information, channel videos, playlists, playlist items, trending videos, and video categories.

Choose the filters, region, category, and pagination fields required by the operation. Returned titles, descriptions, view counts, and engagement metrics can support a content report or help track a channel; this integration reads metadata rather than video transcripts.

Use the block

Search for videos, get trending videos, get video details, get video categories, get channel information, get all videos from a channel, get channel playlists, get playlist items, and get video comments.

Actions

YouTube Channel Info

Get detailed information about a YouTube channel including statistics, branding, and content details.

Inputs and outputs

Input

ParameterTypeRequiredDescription
channelIdstringNoYouTube channel ID starting with "UC" (24-character string, use either channelId or username)
usernamestringNoYouTube channel username (use either channelId or username)
apiKeystringYesYouTube API Key

Output

ParameterTypeDescription
channelIdstringYouTube channel ID
titlestringChannel name
descriptionstringChannel description
subscriberCountnumberNumber of subscribers (0 if hidden)
videoCountnumberNumber of public videos
viewCountnumberTotal channel views
publishedAtstringChannel creation date
thumbnailstringChannel thumbnail/avatar URL
customUrlstringChannel custom URL (handle)
countrystringCountry the channel is associated with
uploadsPlaylistIdstringPlaylist ID containing all channel uploads (use with playlist_items)
bannerImageUrlstringChannel banner image URL
hiddenSubscriberCountbooleanWhether the subscriber count is hidden

YouTube Channel Playlists

Get all public playlists from a specific YouTube channel.

Inputs and outputs

Input

ParameterTypeRequiredDescription
channelIdstringYesYouTube channel ID starting with "UC" (24-character string) to get playlists from
maxResultsnumberNoMaximum number of playlists to return (1-50)
pageTokenstringNoPage token for pagination (from previous response nextPageToken)
apiKeystringYesYouTube API Key

Output

ParameterTypeDescription
itemsarrayArray of playlists from the channel
↳ playlistIdstringYouTube playlist ID
↳ titlestringPlaylist title
↳ descriptionstringPlaylist description
↳ thumbnailstringPlaylist thumbnail URL
↳ itemCountnumberNumber of videos in playlist
↳ publishedAtstringPlaylist creation date
↳ channelTitlestringChannel name
totalResultsnumberTotal number of playlists in the channel
nextPageTokenstringToken for accessing the next page of results

YouTube Channel Videos

Search for videos from a specific YouTube channel with sorting options. For complete channel video list, use channel_info to get uploadsPlaylistId, then use playlist_items.

Inputs and outputs

Input

ParameterTypeRequiredDescription
channelIdstringYesYouTube channel ID starting with "UC" (24-character string) to get videos from
maxResultsnumberNoMaximum number of videos to return (1-50)
orderstringNoSort order: "date" (newest first, default), "rating", "relevance", "title", "viewCount"
pageTokenstringNoPage token for pagination (from previous response nextPageToken)
apiKeystringYesYouTube API Key

Output

ParameterTypeDescription
itemsarrayArray of videos from the channel
↳ videoIdstringYouTube video ID
↳ titlestringVideo title
↳ descriptionstringVideo description
↳ thumbnailstringVideo thumbnail URL
↳ publishedAtstringVideo publish date
↳ channelTitlestringChannel name
totalResultsnumberTotal number of videos in the channel
nextPageTokenstringToken for accessing the next page of results

YouTube Video Comments

Get top-level comments from a YouTube video with author details and engagement.

Inputs and outputs

Input

ParameterTypeRequiredDescription
videoIdstringYesYouTube video ID (11-character string, e.g., "dQw4w9WgXcQ")
maxResultsnumberNoMaximum number of comments to return (1-100)
orderstringNoOrder of comments: "time" (newest first) or "relevance" (most relevant first)
pageTokenstringNoPage token for pagination (from previous response nextPageToken)
apiKeystringYesYouTube API Key

Output

ParameterTypeDescription
itemsarrayArray of top-level comments from the video
↳ commentIdstringComment ID
↳ authorDisplayNamestringComment author display name
↳ authorChannelUrlstringComment author channel URL
↳ authorProfileImageUrlstringComment author profile image URL
↳ textDisplaystringComment text (HTML formatted)
↳ textOriginalstringComment text (plain text)
↳ likeCountnumberNumber of likes on the comment
↳ publishedAtstringWhen the comment was posted
↳ updatedAtstringWhen the comment was last edited
↳ replyCountnumberNumber of replies to this comment
totalResultsnumberTotal number of comment threads available
nextPageTokenstringToken for accessing the next page of results

YouTube Playlist Items

Get videos from a YouTube playlist. Can be used with a channel uploads playlist to get all channel videos.

Inputs and outputs

Input

ParameterTypeRequiredDescription
playlistIdstringYesYouTube playlist ID starting with "PL" or "UU" (34-character string). Use uploadsPlaylistId from channel_info to get all channel videos.
maxResultsnumberNoMaximum number of videos to return (1-50)
pageTokenstringNoPage token for pagination (from previous response nextPageToken)
apiKeystringYesYouTube API Key

Output

ParameterTypeDescription
itemsarrayArray of videos in the playlist
↳ videoIdstringYouTube video ID
↳ titlestringVideo title
↳ descriptionstringVideo description
↳ thumbnailstringVideo thumbnail URL
↳ publishedAtstringDate added to playlist
↳ channelTitlestringPlaylist owner channel name
↳ positionnumberPosition in playlist (0-indexed)
↳ videoOwnerChannelIdstringChannel ID of the video owner
↳ videoOwnerChannelTitlestringChannel name of the video owner
totalResultsnumberTotal number of items in playlist
nextPageTokenstringToken for accessing the next page of results

YouTube Search

Search for videos on YouTube using the YouTube Data API. Supports advanced filtering by channel, date range, duration, category, quality, captions, live streams, and more.

Inputs and outputs

Input

ParameterTypeRequiredDescription
querystringYesSearch query for YouTube videos
maxResultsnumberNoMaximum number of videos to return (1-50)
pageTokenstringNoPage token for pagination (from previous response nextPageToken)
apiKeystringYesYouTube API Key
channelIdstringNoFilter results to a specific YouTube channel ID starting with "UC" (24-character string)
publishedAfterstringNoOnly return videos published after this date (RFC 3339 format: "2024-01-01T00:00:00Z")
publishedBeforestringNoOnly return videos published before this date (RFC 3339 format: "2024-01-01T00:00:00Z")
videoDurationstringNoFilter by video length: "short" (<4 min), "medium" (4-20 min), "long" (>20 min), "any"
orderstringNoSort results by: "date", "rating", "relevance" (default), "title", "videoCount", "viewCount"
videoCategoryIdstringNoFilter by YouTube category ID (e.g., "10" for Music, "20" for Gaming). Use video_categories to list IDs.
videoDefinitionstringNoFilter by video quality: "high" (HD), "standard", "any"
videoCaptionstringNoFilter by caption availability: "closedCaption" (has captions), "none" (no captions), "any"
eventTypestringNoFilter by live broadcast status: "live" (currently live), "upcoming" (scheduled), "completed" (past streams)
regionCodestringNoReturn results relevant to a specific region (ISO 3166-1 alpha-2 country code, e.g., "US", "GB")
relevanceLanguagestringNoReturn results most relevant to a language (ISO 639-1 code, e.g., "en", "es")
safeSearchstringNoContent filtering level: "moderate" (default), "none", "strict"

Output

ParameterTypeDescription
itemsarrayArray of YouTube videos matching the search query
↳ videoIdstringYouTube video ID
↳ titlestringVideo title
↳ descriptionstringVideo description
↳ thumbnailstringVideo thumbnail URL
↳ channelIdstringChannel ID that uploaded the video
↳ channelTitlestringChannel name
↳ publishedAtstringVideo publish date
↳ liveBroadcastContentstringLive broadcast status: "none", "live", or "upcoming"
totalResultsnumberTotal number of search results available
nextPageTokenstringToken for accessing the next page of results

YouTube Trending Videos

Get the most popular/trending videos on YouTube. Can filter by region and video category.

Inputs and outputs

Input

ParameterTypeRequiredDescription
regionCodestringNoISO 3166-1 alpha-2 country code to get trending videos for (e.g., "US", "GB", "JP"). Defaults to US.
videoCategoryIdstringNoFilter by video category ID (e.g., "10" for Music, "20" for Gaming, "17" for Sports)
maxResultsnumberNoMaximum number of trending videos to return (1-50)
pageTokenstringNoPage token for pagination (from previous response nextPageToken)
apiKeystringYesYouTube API Key

Output

ParameterTypeDescription
itemsarrayArray of trending videos
↳ videoIdstringYouTube video ID
↳ titlestringVideo title
↳ descriptionstringVideo description
↳ thumbnailstringVideo thumbnail URL
↳ channelIdstringChannel ID
↳ channelTitlestringChannel name
↳ publishedAtstringVideo publish date
↳ viewCountnumberNumber of views
↳ likeCountnumberNumber of likes
↳ commentCountnumberNumber of comments
↳ durationstringVideo duration in ISO 8601 format
totalResultsnumberTotal number of trending videos available
nextPageTokenstringToken for accessing the next page of results

YouTube Video Categories

Get a list of video categories available on YouTube. Use this to discover valid category IDs for filtering search and trending results.

Inputs and outputs

Input

ParameterTypeRequiredDescription
regionCodestringNoISO 3166-1 alpha-2 country code to get categories for (e.g., "US", "GB", "JP"). Defaults to US.
hlstringNoLanguage for category titles (ISO 639-1 code, e.g., "en", "es", "fr"). Defaults to English.
apiKeystringYesYouTube API Key

Output

ParameterTypeDescription
itemsarrayArray of video categories available in the specified region
↳ categoryIdstringCategory ID to use in search/trending filters (e.g., "10" for Music)
↳ titlestringHuman-readable category name
↳ assignablebooleanWhether videos can be tagged with this category
totalResultsnumberTotal number of categories available

YouTube Video Details

Get detailed information about a specific YouTube video including statistics, content details, live streaming info, and metadata.

Inputs and outputs

Input

ParameterTypeRequiredDescription
videoIdstringYesYouTube video ID (11-character string, e.g., "dQw4w9WgXcQ")
apiKeystringYesYouTube API Key

Output

ParameterTypeDescription
videoIdstringYouTube video ID
titlestringVideo title
descriptionstringVideo description
channelIdstringChannel ID
channelTitlestringChannel name
publishedAtstringPublished date and time
durationstringVideo duration in ISO 8601 format (e.g., "PT4M13S" for 4 min 13 sec)
viewCountnumberNumber of views
likeCountnumberNumber of likes
commentCountnumberNumber of comments
favoriteCountnumberNumber of times added to favorites
thumbnailstringVideo thumbnail URL
tagsarrayVideo tags
categoryIdstringYouTube video category ID
definitionstringVideo definition: "hd" or "sd"
captionstringWhether captions are available: "true" or "false"
licensedContentbooleanWhether the video is licensed content
privacyStatusstringVideo privacy status: "public", "private", or "unlisted"
liveBroadcastContentstringLive broadcast status: "live", "upcoming", or "none"
defaultLanguagestringDefault language of the video metadata
defaultAudioLanguagestringDefault audio language of the video
isLiveContentbooleanWhether this video is or was a live stream
scheduledStartTimestringScheduled start time for upcoming live streams (ISO 8601)
actualStartTimestringWhen the live stream actually started (ISO 8601)
actualEndTimestringWhen the live stream ended (ISO 8601)
concurrentViewersnumberCurrent number of viewers (only for active live streams)
activeLiveChatIdstringLive chat ID for the stream (only for active live streams)
Was this helpful?
Suggest an edit