YouTube

• You want an AI agent to search YouTube for videos, channels, or playlists on a user's behalf without setting up Google OAuth from scratch.
• You need to manage playlists programmatically — creating, updating, deleting, or populating them with videos.
• You need to read or write YouTube data such as channel statistics, video details, subscriptions, or comments.
• You want to act on behalf of a specific authenticated Google account with support for multiple OAuth connections via Maton.

• You need to upload videos — the YouTube Data API upload endpoint is not covered in this skill.
• You are accessing a different third-party service; use the api-gateway skill instead.
• You are hitting YouTube quota limits frequently — search costs 100 quota units per call, so high-volume search workloads may exhaust daily quotas quickly.

All requests are proxied through gateway.maton.ai, which automatically injects your Google OAuth token. You only need a single MATON_API_KEY — no direct Google API credential management required.

Supports search, videos, channels, playlists, playlist items, subscriptions, and comments endpoints. Both read (GET) and write (POST/PUT/DELETE) operations are available.

Manage multiple Google account connections via ctrl.maton.ai. Use the Maton-Connection header to target a specific authenticated account when more than one is active.

Search accepts filters for content type (video, channel, playlist), sort order, publish date ranges, channel ID, and video duration — enabling precise, targeted queries.

Post top-level comments, reply to existing comments, delete comments, subscribe to channels, and check or remove subscriptions — all through the same authenticated gateway.

An agent searches YouTube for videos on a given topic, retrieves view counts and statistics, and summarizes the top results — all via a single skill call with no manual OAuth setup.

A workflow creates a new private playlist, searches for relevant videos, and adds them in order — useful for building study guides, content libraries, or watch queues automatically.

Periodically fetch channel statistics (subscriber count, view count, video count) and surface trending videos for a given region to track channel performance over time.

Read comment threads on uploaded videos, reply to selected comments, or delete inappropriate ones as part of a moderation workflow driven by an AI agent.