| name | youtube-data |
| description | YouTube Data API via youtube-data-cli: search channels/videos, fetch comments/playlists, inspect video metadata, and call raw YouTube Data API v3 endpoints. Use when the user mentions YouTube Data API, channel stats, video search, comments, playlists, or competitor YouTube research. |
| category | social-media |
youtube-data-cli
Use youtube-data-cli for YouTube Data API v3 access.
When To Use This Skill
Use this skill when you need to:
- Search YouTube channels or videos.
- Inspect channel statistics and metadata.
- Fetch video metadata, statistics, and publish dates.
- Read top-level YouTube comments.
- List playlists and playlist items.
- Call a YouTube Data API endpoint that the high-level commands do not expose yet.
Setup
If missing:
bun --version || curl -fsSL https://bun.sh/install | bash
npx api2cli install youtube-data-cli
Authenticate with a YouTube Data API key:
youtube-data-cli auth set "YOUR_YOUTUBE_API_KEY"
youtube-data-cli auth test --json
Token path: ~/.config/tokens/youtube-data-cli.txt.
Working Rules
- Always pass
--json in agent workflows.
- Use high-level resources first:
channels, videos, comments, playlists.
- Use
api get for documented endpoints not covered by shortcuts.
- For large fetches, paginate with
--page-token when the command supports it.
Commands
youtube-data-cli --help
youtube-data-cli channels --help
youtube-data-cli videos --help
youtube-data-cli comments --help
youtube-data-cli playlists --help
youtube-data-cli api --help
Common examples:
youtube-data-cli channels search --q "ai coding" --max-results 10 --json
youtube-data-cli channels get --id CHANNEL_ID --json
youtube-data-cli videos list --channel-id CHANNEL_ID --max-results 10 --json
youtube-data-cli videos get --id VIDEO_ID --json
youtube-data-cli comments list --video-id VIDEO_ID --order relevance --max-results 20 --json
youtube-data-cli playlists list --channel-id CHANNEL_ID --max-results 20 --json
youtube-data-cli playlists items --id PLAYLIST_ID --max-results 20 --json
youtube-data-cli api get --path /search --param part=snippet --param type=video --param q="ai coding" --json
Output Format
--json returns:
{ "ok": true, "data": { "example": true }, "meta": { "total": 1 } }
Errors return:
{ "ok": false, "error": { "message": "...", "status": 400 } }
