YouTube
Badges for YouTube channels and videos — subscribers, views, likes, comments.
Display live stats for YouTube channels and videos.
Subscribers (branded)
Channel views
Video views (outline)
Video likes
Available badges
| Badge | Endpoint | Description |
|---|---|---|
| Subscribers | /youtube/subscribers/{channelId} | Channel subscriber count |
| Channel Views | /youtube/channel-views/{channelId} | Total channel view count |
| Video Views | /youtube/views/{videoId} | Video view count |
| Video Likes | /youtube/likes/{videoId} | Video like count |
| Video Comments | /youtube/comments/{videoId} | Video comment count |
Quick examples
Finding channel IDs
YouTube channel IDs start with UC and are 24 characters long. You can find yours by going to your YouTube channel page and copying the ID from the URL, or by using the YouTube Channel ID Finder.
Some well-known channel IDs:
- Google Developers —
UC_x5XG1OV2P6uZZ5FSM9Ttw - Fireship —
UCsBjURrPoezykLs9EqgamOA - Theo —
UCbRP3c757lWg9M-U7TyEkXA - Traversy Media —
UC29ju8bIPH5as8OGnQzwJyA
Subscribers
GET/youtube/subscribers/:channelId.svg
Path Parameters
required
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/youtube/subscribers/UC_x5XG1OV2P6uZZ5FSM9Ttw.svg?mode=dark"><img alt="badge" src="https://shieldcn.dev/youtube/subscribers/UC_x5XG1OV2P6uZZ5FSM9Ttw.svg?mode=light"></picture>
Channel views
GET/youtube/channel-views/:channelId.svg
Path Parameters
required
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/youtube/channel-views/UC_x5XG1OV2P6uZZ5FSM9Ttw.svg?mode=dark"><img alt="badge" src="https://shieldcn.dev/youtube/channel-views/UC_x5XG1OV2P6uZZ5FSM9Ttw.svg?mode=light"></picture>
Video views
GET/youtube/views/:videoId.svg
Path Parameters
required
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/youtube/views/dQw4w9WgXcQ.svg?mode=dark"><img alt="badge" src="https://shieldcn.dev/youtube/views/dQw4w9WgXcQ.svg?mode=light"></picture>
Video likes
GET/youtube/likes/:videoId.svg
Path Parameters
required
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/youtube/likes/dQw4w9WgXcQ.svg?mode=dark"><img alt="badge" src="https://shieldcn.dev/youtube/likes/dQw4w9WgXcQ.svg?mode=light"></picture>
Video comments
GET/youtube/comments/:videoId.svg
Path Parameters
required
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/youtube/comments/dQw4w9WgXcQ.svg?mode=dark"><img alt="badge" src="https://shieldcn.dev/youtube/comments/dQw4w9WgXcQ.svg?mode=light"></picture>
Setup
Requires YOUTUBE_API_KEY environment variable. Get one from the Google Cloud Console with YouTube Data API v3 enabled.
Data source
Uses YouTube Data API v3. Requires API key. Cached 1 hour.