YouTube stats

uv run --extra youtube tools/youtube_stats.py --account personal                 # every upload, newest first
uv run --extra youtube tools/youtube_stats.py --account personal --video 1hyDgC5Qg_o e4HW-tvi8-8 --since 7d
uv run --extra youtube tools/youtube_stats.py --account personal --github --json  # plus repo referrers

Each run saves a snapshot to _internal/.youtube/stats/<account>/ and reports the change since the last one, so a daily or weekly run is the trend. --no-save for a look without a snapshot.

Setup

It reuses the token youtube_upload.py --auth --account NAME cached, so views, likes and comments work at once. Watch time, retention and traffic sources need the YouTube Analytics API: