Sim

YouTube

Interact with YouTube videos, channels, and playlists

YouTube is the world's largest video sharing platform, hosting billions of videos and serving over 2 billion logged-in monthly users.

With YouTube's extensive API capabilities, you can:

  • Search content: Find relevant videos across YouTube's vast library using specific keywords, filters, and parameters
  • Access metadata: Retrieve detailed information about videos including titles, descriptions, view counts, and engagement metrics
  • Analyze trends: Identify popular content and trending topics within specific categories or regions
  • Extract insights: Gather data about audience preferences, content performance, and engagement patterns

In Sim, the YouTube integration enables your agents to programmatically search and analyze YouTube content as part of their workflows. This allows for powerful automation scenarios that require up-to-date video information. Your agents can search for instructional videos, research content trends, gather information from educational channels, or monitor specific creators for new uploads. This integration bridges the gap between your AI workflows and the world's largest video repository, enabling more sophisticated and content-aware automations. By connecting Sim with YouTube, you can create agents that stay current with the latest information, provide more accurate responses, and deliver more value to users - all without requiring manual intervention or custom code.

Usage Instructions

Integrate YouTube into the workflow. Can search for videos, get video details, get channel information, get all videos from a channel, get channel playlists, get playlist items, find related videos, and get video comments.

Tools

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

Input

ParameterTypeRequiredDescription
querystringYesSearch query for YouTube videos
maxResultsnumberNoMaximum number of videos to return (1-50)
apiKeystringYesYouTube API Key
channelIdstringNoFilter results to a specific YouTube channel ID
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)
videoDefinitionstringNoFilter by video quality: "high" (HD), "standard", "any"
videoCaptionstringNoFilter by caption availability: "closedCaption" (has captions), "none" (no captions), "any"
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

youtube_video_details

Get detailed information about a specific YouTube video.

Input

ParameterTypeRequiredDescription
videoIdstringYesYouTube video ID
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
viewCountnumberNumber of views
likeCountnumberNumber of likes
commentCountnumberNumber of comments
thumbnailstringVideo thumbnail URL
tagsarrayVideo tags

youtube_channel_info

Get detailed information about a YouTube channel.

Input

ParameterTypeRequiredDescription
channelIdstringNoYouTube channel ID (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
videoCountnumberNumber of videos
viewCountnumberTotal channel views
publishedAtstringChannel creation date
thumbnailstringChannel thumbnail URL
customUrlstringChannel custom URL

youtube_channel_videos

Get all videos from a specific YouTube channel, with sorting options.

Input

ParameterTypeRequiredDescription
channelIdstringYesYouTube channel ID to get videos from
maxResultsnumberNoMaximum number of videos to return (1-50)
orderstringNoSort order: "date" (newest first), "rating", "relevance", "title", "viewCount"
pageTokenstringNoPage token for pagination
apiKeystringYesYouTube API Key

Output

ParameterTypeDescription
itemsarrayArray of videos from the channel

youtube_channel_playlists

Get all playlists from a specific YouTube channel.

Input

ParameterTypeRequiredDescription
channelIdstringYesYouTube channel ID to get playlists from
maxResultsnumberNoMaximum number of playlists to return (1-50)
pageTokenstringNoPage token for pagination
apiKeystringYesYouTube API Key

Output

ParameterTypeDescription
itemsarrayArray of playlists from the channel

youtube_playlist_items

Get videos from a YouTube playlist.

Input

ParameterTypeRequiredDescription
playlistIdstringYesYouTube playlist ID
maxResultsnumberNoMaximum number of videos to return
pageTokenstringNoPage token for pagination
apiKeystringYesYouTube API Key

Output

ParameterTypeDescription
itemsarrayArray of videos in the playlist

youtube_comments

Get comments from a YouTube video.

Input

ParameterTypeRequiredDescription
videoIdstringYesYouTube video ID
maxResultsnumberNoMaximum number of comments to return
orderstringNoOrder of comments: time or relevance
pageTokenstringNoPage token for pagination
apiKeystringYesYouTube API Key

Output

ParameterTypeDescription
itemsarrayArray of comments from the video

Notes

  • Category: tools
  • Type: youtube
On this page

On this page

Start building today
Trusted by over 60,000 builders.
Build Agentic workflows visually on a drag-and-drop canvas or with natural language.
Get started