YouTube
App · Video & Audio · 7 actions
Search and explore videos, channels, playlists, and comments on YouTube.
Actions
| Action | What it does |
|---|---|
| Get channel details | Look up a channel's name, description, subscriber count, and view count. |
| Get video details | Look up a video's title, description, view count, likes, and length. |
| List channel playlists | List playlists for a YouTube channel. |
| List trending videos | List the trending videos in a country. |
| List video comments | List the main comments on a video, not the replies. |
| List videos in a playlist | List the videos in a YouTube playlist. |
| Search for videos | Search YouTube for videos that match your keywords. |
Get channel details
Look up a channel's name, description, subscriber count, and view count.
Inputs
- Channel ID
channel_idtextRequired - The ID of the channel to look up.
Outputs
channel_idtext- YouTube channel ID (24-character string starting with 'UC')
descriptiontext- Channel description/about text
related_playlistsobject- Object containing special playlist IDs like 'uploads' (all channel videos). Use uploads playlist ID with youtube_playlist_items action
statustext- Action execution status
subscriber_countnumber- Number of subscribers to this channel. Use for popularity metrics or filtering
titletext- Channel name/title as displayed on YouTube
video_countnumber- Total number of public videos uploaded by this channel
view_countnumber- Total view count across all videos on this channel
Example output
{
"channel_id": {
"id": "abc123",
"name": "Sample"
},
"description": "Sample text content",
"related_playlists": "example_value",
"subscriber_count": 1,
"title": "Sample Item",
"video_count": 1,
"view_count": 1
}Get video details
Look up a video's title, description, view count, likes, and length.
Inputs
- Video ID
video_idtextRequired - The ID of the YouTube video to look up.
Outputs
comment_countnumber- Total number of comments on the video
descriptiontext- Full video description text (may contain links and formatting)
durationtext- Video duration in ISO 8601 format
like_countnumber- Number of likes on the video. Use for engagement metrics
statustext- Action execution status
titletext- Video title as displayed on YouTube
video_idtext- YouTube video ID (11-character string, e.g., 'dQw4w9WgXcQ')
view_countnumber- Total number of views this video has received. Use for popularity metrics or sorting
Example output
{
"comment_count": 1,
"description": "Sample text content",
"duration": "PT4M33S",
"like_count": 1,
"title": "Sample Item",
"video_id": {
"id": "abc123",
"name": "Sample"
},
"view_count": 1
}List channel playlists
List playlists for a YouTube channel.
Inputs
- Channel ID
channel_idtextRequired - Channel ID to list playlists for
- Max results
max_resultsnumber - Maximum number of playlists to return
Outputs
itemslist- Array of playlists for the specified channel. Each playlist contains playlist_id (use with youtube_playlist_items), title, description, and item_count (video count)
next_page_tokentext- Pagination token for fetching the next page of playlists. Null if no more results
statustext- Action execution status
Example output
{
"items": [
{
"description": "Sample text content",
"item_count": 1,
"playlist_id": "PLabc123xyz456",
"title": "Sample Item"
}
],
"next_page_token": "example_value",
"status": "success"
}List trending videos
List the trending videos in a country.
Inputs
- Country code
region_codetext - Two-letter country code for the trending list, for example US or GB.
- Max results
max_resultsnumber - Maximum number of trending videos to return
Outputs
itemslist- Array of trending videos for the specified region. Each video contains video_id (use for details), title, channel info (id/title), view_count, and published_at timestamp. Use for discovering popular content
next_page_tokentext- Pagination token for fetching the next page of trending videos. Null if no more results
statustext- Action execution status
Example output
{
"items": [
{
"channel_id": "UCaBc123XyZ456",
"channel_title": "Sample Item",
"published_at": "2024-01-15T10:30:00Z",
"title": "Sample Item",
"video_id": "dQw4w9WgXcQ",
"view_count": 1
}
],
"next_page_token": "example_value",
"status": "success"
}List video comments
List the main comments on a video, not the replies.
Inputs
- Video ID
video_idtextRequired - The ID of the video to read comments from.
- Max results
max_resultsnumber - Maximum number of comments to return
Outputs
itemslist- Array of top-level comment threads for the video. Each thread contains comment_id, author name, text content, like_count, published_at timestamp, and reply_count. Use for sentiment analysis or displaying user feedback
next_page_tokentext- Pagination token for fetching the next page of comments. Null if no more results
statustext- Action execution status
Example output
{
"items": [
{
"author": "John Doe",
"comment_id": "Ugxabc123xyz",
"like_count": 1,
"published_at": "2024-01-15T10:30:00Z",
"reply_count": 0,
"text": "Sample text content"
}
],
"next_page_token": "example_value",
"status": "success"
}List videos in a playlist
List the videos in a YouTube playlist.
Inputs
- Playlist ID
playlist_idtextRequired - The ID of the playlist to list videos from.
- Max results
max_resultsnumber - Maximum number of videos to return
Outputs
itemslist- Array of videos in the playlist. Each item contains video_id (use for details/comments), title, description, channel_title, and position (order in playlist)
next_page_tokentext- Pagination token for fetching the next page of playlist items. Null if no more results
statustext- Action execution status
Example output
{
"items": [
{
"channel_title": "Sample Item",
"description": "Sample text content",
"position": 0,
"title": "Sample Item",
"video_id": "dQw4w9WgXcQ"
}
],
"next_page_token": "example_value",
"status": "success"
}Search for videos
Search YouTube for videos that match your keywords.
Inputs
- Search terms
querytextRequired - Keywords to search for on YouTube.
- Max results
max_resultsnumber - Maximum number of videos to return
- Sort order
ordertext - How to sort the results, for example by relevance or date.
Outputs
itemslist- Array of video search results. Each item contains video_id (use for details/comments), title, description snippet, channel info (id/title), and published_at timestamp. Use video_id with youtube_video_details for full metadata
next_page_tokentext- Pagination token for fetching the next page of results. Pass this as pageToken parameter to continue listing. Null if no more results
statustext- Action execution status
Example output
{
"items": [
{
"channel_id": "UCaBc123XyZ456",
"channel_title": "Sample Item",
"description": "Sample text content",
"published_at": "2024-01-15T10:30:00Z",
"title": "Sample Item",
"video_id": "dQw4w9WgXcQ"
}
],
"next_page_token": "example_value",
"status": "success"
}