Tools
YouTube
Interact with YouTube videos, channels, and playlists
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.
Search for videos on YouTube using the YouTube Data API. Supports advanced filtering by channel, date range, duration, category, quality, captions, and more.
| Parameter | Type | Required | Description |
|---|
query | string | Yes | Search query for YouTube videos |
maxResults | number | No | Maximum number of videos to return (1-50) |
apiKey | string | Yes | YouTube API Key |
channelId | string | No | Filter results to a specific YouTube channel ID |
publishedAfter | string | No | Only return videos published after this date (RFC 3339 format: "2024-01-01T00:00:00Z") |
publishedBefore | string | No | Only return videos published before this date (RFC 3339 format: "2024-01-01T00:00:00Z") |
videoDuration | string | No | Filter by video length: "short" (<4 min), "medium" (4-20 min), "long" (>20 min), "any" |
order | string | No | Sort results by: "date", "rating", "relevance" (default), "title", "videoCount", "viewCount" |
videoCategoryId | string | No | Filter by YouTube category ID (e.g., "10" for Music, "20" for Gaming) |
videoDefinition | string | No | Filter by video quality: "high" (HD), "standard", "any" |
videoCaption | string | No | Filter by caption availability: "closedCaption" (has captions), "none" (no captions), "any" |
regionCode | string | No | Return results relevant to a specific region (ISO 3166-1 alpha-2 country code, e.g., "US", "GB") |
relevanceLanguage | string | No | Return results most relevant to a language (ISO 639-1 code, e.g., "en", "es") |
safeSearch | string | No | Content filtering level: "moderate" (default), "none", "strict" |
| Parameter | Type | Description |
|---|
items | array | Array of YouTube videos matching the search query |
totalResults | number | Total number of search results available |
nextPageToken | string | Token for accessing the next page of results |
Get detailed information about a specific YouTube video.
| Parameter | Type | Required | Description |
|---|
videoId | string | Yes | YouTube video ID |
apiKey | string | Yes | YouTube API Key |
| Parameter | Type | Description |
|---|
videoId | string | YouTube video ID |
title | string | Video title |
description | string | Video description |
channelId | string | Channel ID |
channelTitle | string | Channel name |
publishedAt | string | Published date and time |
duration | string | Video duration in ISO 8601 format |
viewCount | number | Number of views |
likeCount | number | Number of likes |
commentCount | number | Number of comments |
thumbnail | string | Video thumbnail URL |
tags | array | Video tags |
Get detailed information about a YouTube channel.
| Parameter | Type | Required | Description |
|---|
channelId | string | No | YouTube channel ID (use either channelId or username) |
username | string | No | YouTube channel username (use either channelId or username) |
apiKey | string | Yes | YouTube API Key |
| Parameter | Type | Description |
|---|
channelId | string | YouTube channel ID |
title | string | Channel name |
description | string | Channel description |
subscriberCount | number | Number of subscribers |
videoCount | number | Number of videos |
viewCount | number | Total channel views |
publishedAt | string | Channel creation date |
thumbnail | string | Channel thumbnail URL |
customUrl | string | Channel custom URL |
Get all videos from a specific YouTube channel, with sorting options.
| Parameter | Type | Required | Description |
|---|
channelId | string | Yes | YouTube channel ID to get videos from |
maxResults | number | No | Maximum number of videos to return (1-50) |
order | string | No | Sort order: "date" (newest first), "rating", "relevance", "title", "viewCount" |
pageToken | string | No | Page token for pagination |
apiKey | string | Yes | YouTube API Key |
| Parameter | Type | Description |
|---|
items | array | Array of videos from the channel |
totalResults | number | Total number of videos in the channel |
nextPageToken | string | Token for accessing the next page of results |
Get all playlists from a specific YouTube channel.
| Parameter | Type | Required | Description |
|---|
channelId | string | Yes | YouTube channel ID to get playlists from |
maxResults | number | No | Maximum number of playlists to return (1-50) |
pageToken | string | No | Page token for pagination |
apiKey | string | Yes | YouTube API Key |
| Parameter | Type | Description |
|---|
items | array | Array of playlists from the channel |
totalResults | number | Total number of playlists in the channel |
nextPageToken | string | Token for accessing the next page of results |
Get videos from a YouTube playlist.
| Parameter | Type | Required | Description |
|---|
playlistId | string | Yes | YouTube playlist ID |
maxResults | number | No | Maximum number of videos to return |
pageToken | string | No | Page token for pagination |
apiKey | string | Yes | YouTube API Key |
| Parameter | Type | Description |
|---|
items | array | Array of videos in the playlist |
totalResults | number | Total number of items in playlist |
nextPageToken | string | Token for accessing the next page of results |
Get comments from a YouTube video.
| Parameter | Type | Required | Description |
|---|
videoId | string | Yes | YouTube video ID |
maxResults | number | No | Maximum number of comments to return |
order | string | No | Order of comments: time or relevance |
pageToken | string | No | Page token for pagination |
apiKey | string | Yes | YouTube API Key |
| Parameter | Type | Description |
|---|
items | array | Array of comments from the video |
totalResults | number | Total number of comments |
nextPageToken | string | Token for accessing the next page of results |
- Category:
tools
- Type:
youtube
