Docker Hub
Badges for Docker images — pulls, stars, version, image size.
Display live stats for any image on Docker Hub.
Pulls (branded)
Stars
Image size (outline)
Pulls (outline)
Available badges
| Badge | Endpoint | Description |
|---|---|---|
| Pulls | /docker/pulls/{image} | Total pull count |
| Stars | /docker/stars/{image} | Star count |
| Version | /docker/v/{image} | Latest tag |
| Image Size | /docker/size/{image} | Compressed image size |
Quick examples
GET/docker/pulls/:image.svg
Path Parameters
required
Use library/ prefix for official images.
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/docker/pulls/library%2Fnginx.svg?mode=dark"><img alt="badge" src="https://shieldcn.dev/docker/pulls/library%2Fnginx.svg?mode=light"></picture>
Image naming
- Official images:
library/nginx,library/alpine,library/node - User images:
grafana/grafana,portainer/portainer
Data source
Uses Docker Hub API v2. No API key required. Cached 1 hour.