YouTube

- `max_results` (int, optional) — Maximum playlists to return (max: 50, default: 25)

{
  "kind": "youtube#playlistListResponse",
  "pageInfo": { "totalResults": 5, "resultsPerPage": 25 },
  "items": [{ "id": "PL...", "snippet": { "title": "My Playlist", "itemCount": 10 } }]
}

- `max_results` (int, optional) — Maximum subscriptions to return (max: 50, default: 25)

{
  "kind": "youtube#subscriptionListResponse",
  "items": [{
    "snippet": {
      "title": "Channel Name",
      "resourceId": { "channelId": "UC..." }
    }
  }]
}

- `max_results` (int, optional) — Maximum activities to return (max: 50, default: 25)

{
  "kind": "youtube#activityListResponse",
  "items": [{
    "snippet": { "type": "upload", "publishedAt": "2024-01-15T..." },
    "contentDetails": { "upload": { "videoId": "abc123" } }
  }]
}

- `query` (string, required) — Search query text
- `max_results` (int, optional) — Maximum videos to return (max: 50, default: 10)
- `order` (string, optional) — Sort order: relevance, date, rating, title, videoCount, or viewCount (default: relevance)

{
  "kind": "youtube#searchListResponse",
  "pageInfo": { "totalResults": 1000000 },
  "items": [{
    "id": { "videoId": "dQw4w9WgXcQ" },
    "snippet": { "title": "Video Title", "channelTitle": "Channel Name", "publishedAt": "..." }
  }]
}

- `video_id` (string, required) — YouTube video ID (e.g., dQw4w9WgXcQ)

{
  "kind": "youtube#videoListResponse",
  "items": [{
    "id": "dQw4w9WgXcQ",
    "snippet": { "title": "...", "description": "...", "publishedAt": "..." },
    "statistics": { "viewCount": "1500000", "likeCount": "50000" },
    "contentDetails": { "duration": "PT3M33S" },
    "status": { "privacyStatus": "public" }
  }]
}

- `channel_id` (string, required) — YouTube channel ID (e.g., UCxxxxxx)
- `max_results` (int, optional) — Maximum videos to return (max: 50, default: 25)

{
  "kind": "youtube#searchListResponse",
  "items": [{
    "id": { "videoId": "abc123" },
    "snippet": { "title": "Latest Video", "publishedAt": "2024-01-15T..." }
  }]
}

- `video_id` (string, required) — YouTube video ID
- `max_results` (int, optional) — Maximum comments to return (max: 100, default: 20)
- `order` (string, optional) — Comment order: relevance or time (default: relevance)

{
  "kind": "youtube#commentThreadListResponse",
  "items": [{
    "snippet": {
      "topLevelComment": {
        "snippet": { "textDisplay": "Great video!", "likeCount": 42, "authorDisplayName": "..." }
      },
      "totalReplyCount": 3
    }
  }]
}

- `video_id` (string, required) — YouTube video ID
- `rating` (string, required) — Rating value: like, dislike, or none

{
  "message": "Video rated as 'like' successfully"
}

- `video_id` (string, required) — YouTube video ID
- `text` (string, required) — Comment text content

{
  "kind": "youtube#commentThread",
  "id": "comment-thread-id",
  "snippet": {
    "topLevelComment": { "snippet": { "textOriginal": "Great video!", "publishedAt": "..." } }
  }
}

- `playlist_id` (string, required) — YouTube playlist ID (e.g., PLxxxxxx)
- `max_results` (int, optional) — Maximum items to return (max: 50, default: 50)

{
  "kind": "youtube#playlistItemListResponse",
  "pageInfo": { "totalResults": 20 },
  "items": [{
    "snippet": { "title": "Video Title", "position": 0, "resourceId": { "videoId": "abc123" } }
  }]
}

- `title` (string, required) — Playlist title
- `description` (string, optional) — Playlist description (default: "")
- `privacy_status` (string, optional) — Privacy setting: private, public, or unlisted (default: private)

{
  "kind": "youtube#playlist",
  "id": "PL...",
  "snippet": { "title": "My New Playlist", "description": "..." },
  "status": { "privacyStatus": "private" }
}

- `playlist_id` (string, required) — Target playlist ID
- `video_id` (string, required) — Video ID to add

{
  "kind": "youtube#playlistItem",
  "id": "playlist-item-id",
  "snippet": { "playlistId": "PL...", "resourceId": { "videoId": "abc123" }, "position": 5 }
}

- `channel_id` (string, required) — YouTube channel ID to subscribe to (e.g., UCxxxxxx)

{
  "kind": "youtube#subscription",
  "id": "subscription-id",
  "snippet": {
    "title": "Channel Name",
    "resourceId": { "channelId": "UC..." }
  }
}

video:    https://youtube.com/watch?v=dQw4w9WgXcQ  → dQw4w9WgXcQ
Channel:  https://youtube.com/channel/UCxxxxxx      → UCxxxxxx
Playlist: https://youtube.com/playlist?list=PLxxxxx → PLxxxxx

pt3m33s  → 3 minutes, 33 seconds
PT1H2M   → 1 hour, 2 minutes
PT45S    → 45 seconds