youtube-analytics-cli

yt — YouTube Analytics CLI

Growth-oriented YouTube analytics from your terminal.

Features

• Channel overview — subscribers, views, and video count at a glance
• Analytics dashboard — views, watch time, subscribers, revenue over any period
• Video deep dive — packaging, retention, engagement, growth, monetization, and audience breakdown for a single video
• Diagnostics — automated insights (CTR, retention, sub conversion) with actionable recommendations
• Top videos — rank videos by any metric (views, revenue, likes, etc.)
• Multi-account — manage multiple YouTube channels with named aliases
• Flexible output — colored tables (default), JSON (--json), or plain TSV (--plain)
• Custom queries — arbitrary metrics, dimensions, filters, and sorting

Installation

With go install

go install github.com/shubs/youtube-analytics-cli/cmd/yt@latest

From source

git clone https://github.com/shubs/youtube-analytics-cli.git
cd youtube-analytics-cli
make build
# Binary is at ./bin/yt

Quick Start

1. Set up OAuth credentials

You need Google Cloud OAuth 2.0 credentials with the YouTube Analytics and YouTube Data API enabled. See CONTRIBUTING.md for details.

yt auth setup <CLIENT_ID> <CLIENT_SECRET>

2. Log in

yt auth login

This opens your browser for OAuth consent. The token is stored securely in your system keyring.

3. Explore

# Channel overview
yt channel

# Last 28 days analytics
yt analytics overview

# Last 7 days
yt analytics overview --since 7d

# Top 10 videos by views
yt videos top --since 90d

# Deep dive on a specific video
yt video <VIDEO_ID>

# Revenue breakdown by country
yt analytics revenue -d country --since 90d

# Output as JSON
yt analytics overview --json

Command Reference

Prerequisites

• Go 1.24+
• Google Cloud project with OAuth 2.0 credentials (Desktop app type)
• APIs enabled: YouTube Data API v3 and YouTube Analytics API

License

MIT