YouTube

Badges for YouTube channels and videos — subscribers, views, likes, comments.

Display live stats for YouTube channels and videos.

subscribers
Subscribers (branded)
channel views
Channel views
video views
Video views (outline)
likes
Video likes

Available badges

BadgeEndpointDescription
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

![subscribers](https://shieldcn.dev/youtube/subscribers/UC_x5XG1OV2P6uZZ5FSM9Ttw.svg)
![channel views](https://shieldcn.dev/youtube/channel-views/UC_x5XG1OV2P6uZZ5FSM9Ttw.svg)
![views](https://shieldcn.dev/youtube/views/dQw4w9WgXcQ.svg)
![likes](https://shieldcn.dev/youtube/likes/dQw4w9WgXcQ.svg)
![comments](https://shieldcn.dev/youtube/comments/dQw4w9WgXcQ.svg)

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 DevelopersUC_x5XG1OV2P6uZZ5FSM9Ttw
  • FireshipUCsBjURrPoezykLs9EqgamOA
  • TheoUCbRP3c757lWg9M-U7TyEkXA
  • Traversy MediaUC29ju8bIPH5as8OGnQzwJyA

Subscribers

GET/youtube/subscribers/:channelId.svg

Path Parameters

required
![badge](https://shieldcn.dev/youtube/subscribers/UC_x5XG1OV2P6uZZ5FSM9Ttw.png)
badge preview

Channel views

GET/youtube/channel-views/:channelId.svg

Path Parameters

required
![badge](https://shieldcn.dev/youtube/channel-views/UC_x5XG1OV2P6uZZ5FSM9Ttw.png)
badge preview

Video views

GET/youtube/views/:videoId.svg

Path Parameters

required
![badge](https://shieldcn.dev/youtube/views/dQw4w9WgXcQ.png)
badge preview

Video likes

GET/youtube/likes/:videoId.svg

Path Parameters

required
![badge](https://shieldcn.dev/youtube/likes/dQw4w9WgXcQ.png)
badge preview

Video comments

GET/youtube/comments/:videoId.svg

Path Parameters

required
![badge](https://shieldcn.dev/youtube/comments/dQw4w9WgXcQ.png)
badge preview

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.