---
name: youtube
description: Search YouTube videos, channels, and shorts with advanced filters, track video rankings, get detailed video information with transcripts and comments, analyze channel performance, and discover trending content. Use when users need to find videos, research content creators, track video positions for SEO, analyze engagement metrics, or discover trending topics.
metadata:
author: MCP360
version: "1.0.0"
tags:
- Video Platform
- Content Discovery
- YouTube
- Video Search
- Channel Analytics
- Trending Content
- Video SEO
- Social Media
keywords:
- youtube
- video
- videos
- channel
- channels
- trending
- shorts
- content
- creator
- vlog
- tutorial
- entertainment
- search videos
- video search
- youtube search
- ranking
- position tracking
creditsPerUse: 1
isPremium: false
---
# YouTube Tools
Comprehensive YouTube API for video discovery, channel research, content analytics, and ranking intelligence. Access YouTube's vast video library with advanced search filters, get detailed video metadata including transcripts and comments, track video rankings, and analyze trending content across regions.
## Core Capabilities
- **Video Search**: Find videos with filters for region, language, and advanced parameters, and returns video listings with titles, thumbnails, view counts, upload dates, channel information, and engagement metrics
- **Channel Search**: Discover YouTube channels by keywords and topics, and returns channel profiles with subscriber counts, video counts, descriptions, and verification status for influencer research
- **Shorts Search**: Find trending YouTube Shorts and vertical videos, and returns short-form content with view counts, engagement rates, and viral metrics for content strategy
- **Video Details**: Get comprehensive video information including description, tags, and statistics, and returns full metadata with duration, category, license, upload date, and performance analytics
- **Video Transcripts**: Extract complete video transcripts and captions in multiple languages, and returns timestamped text content for accessibility, content analysis, and SEO optimization
- **Video Comments**: Retrieve top comments and community engagement data, and returns comment threads with like counts, reply counts, and sentiment indicators for audience insights
- **Channel Details**: Access complete channel information and statistics, and returns subscriber growth, total views, video count, channel description, and social links
- **Channel Videos**: List all videos from a specific channel with sorting options, and returns video catalog with upload schedule, performance metrics, and content patterns
- **Trending Videos**: Discover currently trending videos by region and category, and returns viral content with trending scores, view velocity, and popularity indicators
- **Video Position Tracking**: Monitor where videos rank for specific search keywords, and returns exact positions, visibility metrics, and ranking changes for YouTube SEO
- **Bulk Position Tracking**: Track multiple videos across various keywords simultaneously, and returns comprehensive ranking data with competitive analysis and trend identification
## API Access
### MCP360 Connect Endpoints
- **Base URL**: `https://connect.mcp360.ai/api/v1`
- **Service Path**: `youtube`
- **Authentication**: Bearer token (API key required)
### Service Metadata Endpoint
Retrieve service information and available tools:
```bash
curl "https://connect.mcp360.ai/api/v1/youtube" \
-H "Authorization: Bearer YOUR_API_KEY"
```
### Tool Execution Endpoint
Execute specific tools by making POST requests:
```bash
curl -X POST "https://connect.mcp360.ai/api/v1/youtube/{tool_name}" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{...parameters...}'
```
## Available Tools
### Search Videos
Find YouTube videos using keywords with regional and language filters for localized content discovery.
**Tool Name:** `search_videos`
**Credits Required:** 1
**Parameters:**
- `query` (string, required): Search terms like "python tutorial", "cooking recipes", or "product review"
- `country` (string, optional): Country code for regional results like "us", "uk", "jp", "de"
- `language` (string, optional): Language code for interface like "en", "es", "fr", "ja"
- `sp` (string, optional): Special YouTube filter parameter for advanced filtering (duration, upload date, quality)
**Example:**
```bash
curl -X POST "https://connect.mcp360.ai/api/v1/youtube/search_videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "machine learning tutorial 2024",
"country": "us",
"language": "en"
}'
```
### Search Channels
Discover YouTube channels by topic, niche, or creator name for influencer outreach and competitor research.
**Tool Name:** `search_channels`
**Credits Required:** 1
**Parameters:**
- `query` (string, required): Channel search terms like "tech reviews", "fitness coach", or specific channel name
- `country` (string, optional): Country code for regional channels like "us", "uk", "ca"
- `language` (string, optional): Language preference like "en", "es", "pt"
- `sp` (string, optional): Advanced filter parameter for channel sorting
**Example:**
```bash
curl -X POST "https://connect.mcp360.ai/api/v1/youtube/search_channels" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "gaming channels",
"country": "us",
"language": "en"
}'
```
### Search Shorts
Find YouTube Shorts and vertical video content for trend analysis and short-form content research.
**Tool Name:** `search_shorts`
**Credits Required:** 1
**Parameters:**
- `query` (string, required): Shorts search query like "quick recipes", "life hacks", or trending topics
- `country` (string, optional): Region code like "us", "uk", "in"
- `language` (string, optional): Language code like "en", "hi", "es"
- `sp` (string, optional): Filter parameter for shorts-specific sorting
**Example:**
```bash
curl -X POST "https://connect.mcp360.ai/api/v1/youtube/search_shorts" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "fitness tips",
"country": "us"
}'
```
### Get Video Details
Retrieve comprehensive metadata for a specific video including description, tags, statistics, and performance metrics.
**Tool Name:** `get_video_details`
**Credits Required:** 1
**Parameters:**
- `video_id` (string, required): YouTube video ID like "dQw4w9WgXcQ" from URL youtube.com/watch?v=VIDEO_ID
- `country` (string, optional): Country code for regional view counts like "us", "uk"
**Example:**
```bash
curl -X POST "https://connect.mcp360.ai/api/v1/youtube/get_video_details" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"video_id": "dQw4w9WgXcQ",
"country": "us"
}'
```
### Get Video Transcripts
Extract video transcripts and closed captions for content analysis, SEO, and accessibility.
**Tool Name:** `get_video_transcripts`
**Credits Required:** 1
**Parameters:**
- `video_id` (string, required): YouTube video ID like "dQw4w9WgXcQ"
- `language` (string, optional): Preferred transcript language code like "en", "es", "fr" (Default: auto-detect)
**Example:**
```bash
curl -X POST "https://connect.mcp360.ai/api/v1/youtube/get_video_transcripts" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"video_id": "dQw4w9WgXcQ",
"language": "en"
}'
```
### Get Video Comments
Retrieve top comments and engagement data from video comment sections for sentiment analysis.
**Tool Name:** `get_video_comments`
**Credits Required:** 1
**Parameters:**
- `video_id` (string, required): YouTube video ID like "dQw4w9WgXcQ"
- `sort_by` (string, optional): Sort order - "top" for most liked, "new" for most recent (Default: "top")
- `max_results` (number, optional): Number of comments to retrieve from 1 to 100 (Default: 20)
**Example:**
```bash
curl -X POST "https://connect.mcp360.ai/api/v1/youtube/get_video_comments" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"video_id": "dQw4w9WgXcQ",
"sort_by": "top",
"max_results": 50
}'
```
### Get Channel Details
Access complete channel information including statistics, description, and social media links.
**Tool Name:** `get_channel_details`
**Credits Required:** 1
**Parameters:**
- `channel_id` (string, required): YouTube channel ID like "UCuAXFkgsw1L7xaCfnd5JJOw" or channel username
**Example:**
```bash
curl -X POST "https://connect.mcp360.ai/api/v1/youtube/get_channel_details" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"channel_id": "UCuAXFkgsw1L7xaCfnd5JJOw"
}'
```
### Get Channel Videos
List all videos from a specific channel with sorting and filtering options.
**Tool Name:** `get_channel_videos`
**Credits Required:** 1
**Parameters:**
- `channel_id` (string, required): YouTube channel ID or username
- `sort_by` (string, optional): Sort order - "date", "popular", "rating" (Default: "date")
- `max_results` (number, optional): Number of videos to retrieve from 1 to 50 (Default: 30)
**Example:**
```bash
curl -X POST "https://connect.mcp360.ai/api/v1/youtube/get_channel_videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"channel_id": "UCuAXFkgsw1L7xaCfnd5JJOw",
"sort_by": "popular",
"max_results": 30
}'
```
### Get YouTube Trends
Discover currently trending videos by region and category for content strategy and trend analysis.
**Tool Name:** `get_youtube_trends`
**Credits Required:** 1
**Parameters:**
- `country` (string, optional): Country code for regional trends like "us", "uk", "jp" (Default: "us")
- `category` (string, optional): Video category like "Gaming", "Music", "Technology", "Entertainment"
**Example:**
```bash
curl -X POST "https://connect.mcp360.ai/api/v1/youtube/get_youtube_trends" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"country": "us",
"category": "Technology"
}'
```
### Find Video Position
Track where a specific video ranks in YouTube search results for targeted keywords.
**Tool Name:** `find_video_position`
**Credits Required:** 1
**Parameters:**
- `keyword` (string, required): Search query to check video ranking for like "python tutorial" or "best gaming laptop 2024"
- `video_url` (string, required): YouTube video URL like "https://youtube.com/watch?v=VIDEO_ID" or just video ID
- `country` (string, optional): Country code for regional rankings like "us", "uk" (Default: "us")
**Example:**
```bash
curl -X POST "https://connect.mcp360.ai/api/v1/youtube/find_video_position" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"keyword": "react tutorial for beginners",
"video_url": "https://youtube.com/watch?v=dQw4w9WgXcQ",
"country": "us"
}'
```
### Bulk Find Video Position
Track multiple keywords for a single video in one request for comprehensive YouTube SEO analysis.
**Tool Name:** `bulk_find_video_position`
**Credits Required:** 5
**Parameters:**
- `keywords` (array of string, required): Array of search queries to check rankings for, maximum 10 keywords like ["react tutorial", "javascript course"]
- `video_url` (string, required): YouTube video URL or video ID
- `country` (string, optional): Country code for regional tracking like "us", "uk" (Default: "us")
**Example:**
```bash
curl -X POST "https://connect.mcp360.ai/api/v1/youtube/bulk_find_video_position" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"keywords": [
"web development tutorial",
"learn web development",
"full stack course",
"coding for beginners"
],
"video_url": "dQw4w9WgXcQ",
"country": "us"
}'
```
## Authentication
All API requests require a Bearer token for authentication:
```bash
-H "Authorization: Bearer YOUR_API_KEY"
```
## Rate Limiting
- Standard tools (search, details, comments, transcripts, channel info, trends): 1 credit per request
- Bulk position tracking (bulk_find_video_position): 5 credits per request
- Rate limit: 1000 requests per hour
- Concurrent requests: Up to 10 parallel calls
## Support
- **Blog & Tutorials**: https://mcp360.ai/blog
- **Contact**: https://mcp360.ai/contact