YouTube

Search videos, get channel stats, and manage playlists via the YouTube Data API v3.

Environment Variables

• GOOGLE_ACCESS_TOKEN - OAuth 2.0 access token with YouTube scope

Search videos

curl -s -H "Authorization: Bearer $GOOGLE_ACCESS_TOKEN" \
  "https://www.googleapis.com/youtube/v3/search?part=snippet&type=video&q=SEARCH_QUERY&maxResults=5" | jq '.items[] | {videoId: .id.videoId, title: .snippet.title, channel: .snippet.channelTitle}'

Get video details

curl -s -H "Authorization: Bearer $GOOGLE_ACCESS_TOKEN" \
  "https://www.googleapis.com/youtube/v3/videos?part=snippet,statistics&id=VIDEO_ID" | jq '.items[0] | {title: .snippet.title, views: .statistics.viewCount, likes: .statistics.likeCount}'

Get channel stats

curl -s -H "Authorization: Bearer $GOOGLE_ACCESS_TOKEN" \
  "https://www.googleapis.com/youtube/v3/channels?part=statistics,snippet&id=CHANNEL_ID" | jq '.items[0] | {title: .snippet.title, subscribers: .statistics.subscriberCount, videos: .statistics.videoCount}'

List playlists

curl -s -H "Authorization: Bearer $GOOGLE_ACCESS_TOKEN" \
  "https://www.googleapis.com/youtube/v3/playlists?part=snippet&mine=true&maxResults=10" | jq '.items[] | {id, title: .snippet.title}'

Notes

• Access token must have https://www.googleapis.com/auth/youtube.readonly scope.