{"skill":{"slug":"clawbus-youtube-unified-api","displayName":"YouTube API","summary":"Use when YouTube data is needed through MyBrandMetrics: search YouTube videos, get video metadata, inspect channel info, browse playlists, list comments, che...","description":"---\nname: YouTube API\ndescription: >\n  Use when YouTube data is needed through MyBrandMetrics: search YouTube\n  videos, get video metadata, inspect channel info, browse playlists, list\n  comments, check live broadcasts, query YouTube Analytics, and work with\n  YouTube Reporting jobs. Covers YouTube Data API v3, YouTube Analytics API v2,\n  and YouTube Reporting API v1 after YouTube is connected in MyBrandMetrics.\n---\n\n# YouTube API\n\nSearch YouTube videos, get YouTube video metadata, inspect channel info, browse\nplaylists, list comments, check live broadcasts, query YouTube Analytics, and\nwork with YouTube Reporting jobs through the MyBrandMetrics Discovery API.\n\nUse this skill when YouTube content or YouTube account data is needed after\nYouTube is connected in MyBrandMetrics. It covers YouTube Data API v3, YouTube\nAnalytics API v2, and YouTube Reporting API v1 from one interface.\n\nThis skill is for YouTube data, analytics, reporting, and upload-route\nworkflows. It does not provide YouTube transcripts.\n\nWebsite: [https://www.clawbus.com/](https://www.clawbus.com/)  \nMyBrandMetrics API: [https://mybrandmetrics.com/](https://mybrandmetrics.com/)\n\n## Core Capabilities\n\n| Capability | Details |\n| --- | --- |\n| YouTube API access | Work with YouTube Data API v3, YouTube Analytics API v2, and YouTube Reporting API v1 from one skill. |\n| YouTube search results | Search YouTube videos, channels, playlists, and live content with query, channel, date, region, and result filters. |\n| Video metadata | Get YouTube video title, description, thumbnails, publish date, duration, status, and statistics. |\n| Channel info | Get YouTube channel details, subscriptions, playlists, playlist items, and related resources. |\n| Comments and discussions | List YouTube comment threads and related comment data for videos or channels. |\n| Live broadcasts | List and inspect YouTube live broadcasts and related live resources. |\n| Upload routes | Use YouTube video upload routes, including multipart and resumable upload patterns. |\n| YouTube Analytics | Query YouTube Analytics reports for connected channels, videos, and creator content. |\n| YouTube Reporting | List YouTube Reporting API report types, create reporting jobs, and inspect generated reporting resources. |\n| Endpoint references | Use generated service references and a compact catalog for endpoint lookup. |\n\n## Setup Flow\n\n1. Open [https://mybrandmetrics.com/](https://mybrandmetrics.com/) and sign in\n   with Google.\n2. In MyBrandMetrics, open **Data sources**.\n3. Connect YouTube as a data source.\n4. Wait until the MyBrandMetrics YouTube connection is ready.\n5. In [https://mybrandmetrics.com/](https://mybrandmetrics.com/), get the\n   MyBrandMetrics API key.\n6. Install the `clawbus-youtube-unified-api` skill.\n7. Start a YouTube search, channel lookup, playlist workflow, analytics query,\n   reporting job, or upload workflow with natural-language instructions or\n   direct Discovery API requests.\n\n## Authentication\n\nUse the MyBrandMetrics API key for Discovery API requests.\n\n```bash\nexport MYBRANDMETRICS_API_KEY=\"YOUR_API_KEY\"\nexport MYBRANDMETRICS_API_BASE_URL=\"https://api.mybrandmetrics.com\"\n```\n\nPass the key in the request header:\n\n```text\nX-API-Key: YOUR_API_KEY\n```\n\nDo not put real API keys, account session values, or Google access tokens in\nskill files, examples, logs, or chat replies.\n\n## Discovery Routing\n\nUse `/discovery/{service}/{path}`.\n\n| Service | Google API | Example route |\n| --- | --- | --- |\n| `youtube` | YouTube Data API v3 | `/discovery/youtube/channels` |\n| `youtubeAnalytics` | YouTube Analytics API v2 | `/discovery/youtubeAnalytics/reports` |\n| `youtubeReporting` | YouTube Reporting API v1 | `/discovery/youtubeReporting/jobs` |\n\nCommon version prefixes are omitted in the generated examples.\n\n## Search-Friendly Workflows\n\nCommon YouTube workflows include:\n\n- search YouTube videos by keyword, channel, date, region, or content type;\n- get YouTube video metadata, thumbnails, statistics, captions, and status;\n- inspect YouTube channel info, playlists, playlist items, comments, and\n  subscriptions;\n- browse YouTube playlists and channel uploads;\n- list YouTube comments and discussion threads;\n- query YouTube Analytics metrics such as views, watch time, and engagement;\n- create and inspect YouTube Reporting API jobs;\n- prepare YouTube upload requests for connected channels.\n\n## Account Selection\n\nIf the MyBrandMetrics API key is connected to more than one YouTube account,\nchoose the account for the request before running it.\n\nWhen MyBrandMetrics returns an account selection response, show only\nnon-sensitive account labels such as display name, email, and connection ID.\nThen include the selected account identifier, such as `oauth_connection_id`, in\nthe Discovery API request.\n\n## Example Requests\n\nGet connected channel details:\n\n```bash\ncurl -H \"X-API-Key: $MYBRANDMETRICS_API_KEY\" \\\n  \"${MYBRANDMETRICS_API_BASE_URL:-https://api.mybrandmetrics.com}/discovery/youtube/channels?part=snippet,contentDetails,statistics&mine=true\"\n```\n\nQuery YouTube Analytics:\n\n```bash\ncurl -sS \"${MYBRANDMETRICS_API_BASE_URL:-https://api.mybrandmetrics.com}/discovery/youtubeAnalytics/reports\" \\\n  -H \"X-API-Key: $MYBRANDMETRICS_API_KEY\" \\\n  --url-query \"ids=channel==MINE\" \\\n  --url-query \"startDate=2026-01-01\" \\\n  --url-query \"endDate=2026-01-31\" \\\n  --url-query \"metrics=views,estimatedMinutesWatched\"\n```\n\nNatural-language examples:\n\n```text\nFind recent YouTube videos about creator analytics and return titles, URLs, and view counts.\n```\n\n```text\nGet analytics for my connected YouTube channel for the last 30 days.\n```\n\n```text\nList playlists from my connected YouTube channel and show the first 10 playlist items.\n```\n\n## Reference Files\n\n| File | Purpose |\n| --- | --- |\n| `references/index.md` | Reference overview and load order. |\n| `references/curl.md` | Curl workflow, request construction, upload, download, and errors. |\n| `references/mybrandmetrics-api.md` | Discovery routing, account selection, and MyBrandMetrics request rules. |\n| `references/services/youtube-data-v3.md` | YouTube Data API v3 endpoint reference. |\n| `references/services/youtube-analytics-v2.md` | YouTube Analytics API v2 endpoint reference. |\n| `references/services/youtube-reporting-v1.md` | YouTube Reporting API v1 endpoint reference. |\n| `references/catalog.json` | Compact machine-readable endpoint catalog. |\n\nBefore upload, update, delete, or reporting-job workflows, confirm the connected\nYouTube account, target resource, request parameters, and intended result.\n","tags":{"analytics":"1.2.4","channel":"1.2.4","creator":"1.2.4","google-api":"1.2.4","latest":"1.2.4","metadata":"1.2.4","playlists":"1.2.4","reporting":"1.2.4","video":"1.2.4","youtube":"1.2.4","youtube-api":"1.2.4","youtube-data":"1.2.4"},"stats":{"comments":0,"downloads":833,"installsAllTime":1,"installsCurrent":1,"stars":0,"versions":7},"createdAt":1778225015852,"updatedAt":1779263297373},"latestVersion":{"version":"1.2.4","createdAt":1779263297373,"changelog":"Improve YouTube search relevance","license":"MIT-0"},"metadata":null,"owner":{"handle":"clawbus","userId":"s1714nww0520qjy3akv321qsjs86bfp7","displayName":"clawbus","image":"https://avatars.githubusercontent.com/u/191543806?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1779976864473}}