GET
/api/user/stats
User Statistics
Retrieve total pull counts and repository statistics for a Docker Hub user. This endpoint aggregates data across all public repositories belonging to the specified user.
usernameRequired
Docker Hub username
string
fieldsOptional
Comma-separated list of fields to return. Available: name, full_name, namespace, pull_count, star_count, repo_count, last_updated
string
Example Response
{
"name": "xuxuclassmate",
"namespace": "xuxuclassmate",
"pull_count": 1234567,
"star_count": 42,
"repo_count": 12,
"last_updated": "2026-04-24T00:00:00Z"
}
GET
/api/docker-stats
Docker Stats Card
Returns an SVG image card with fresh Docker Hub user statistics. Perfect for embedding in README files or documentation pages.
usernameRequired
Docker Hub username
string
Embed Code
<img src="https://docker-hub-pull-counter.vercel.app/api/docker-stats?username=xuxuclassmate" alt="Docker Hub Stats" />
GET
/api/repo/details
Repository Details
Get detailed information about a specific Docker Hub repository including description, star count, pull count, automated build status, and media types.
namespaceRequired
Repository namespace or user/organization name
string
repoRequired
Repository name
string
Example Response
{
"name": "nginx",
"namespace": "library",
"full_name": "library/nginx",
"description": "Official build of Nginx.",
"pull_count": 12345678901,
"star_count": 19999,
"is_automated": false,
"is_private": false,
"last_updated": "2026-04-23T12:00:00Z",
"media_types": ["application/vnd.docker.container.image.v1+json"],
"volumes": ["var/cache/nginx", "var/log/nginx", "var/run"]
}
GET
/api/repo/tags
Repository Tags
List all available tags for a repository along with their digests, sizes, and last updated timestamps. Results are sorted by most recently updated.
namespaceRequired
Repository namespace or user/organization name
string
repoRequired
Repository name
string
limitOptional
Maximum number of tags to return (default: 100, max: 1000)
integer
Example Response
{
"namespace": "library",
"repo": "nginx",
"tags": [
{
"name": "latest",
"digest": "sha256:abc123...",
"size": "142MB",
"last_updated": "2026-04-20T08:00:00Z"
},
{
"name": "1.27-alpine",
"digest": "sha256:def456...",
"size": "42MB",
"last_updated": "2026-04-18T14:30:00Z"
}
],
"total": 250
}
GET
/api/search
Search
Search Docker Hub repositories by keyword. Supports pagination and filtering by repository is_official flag. Results are ranked by relevance and popularity.
qRequired
Search query string
string
pageOptional
Page number for pagination (default: 1)
integer
page_sizeOptional
Number of results per page (default: 25, max: 100)
integer
Example Response
{
"query": "nginx",
"page": 1,
"page_size": 25,
"count": 25,
"total": 1500,
"results": [
{
"name": "nginx",
"namespace": "library",
"description": "Official build of Nginx.",
"pull_count": 12345678901,
"star_count": 19999,
"is_official": true
},
{
"name": "nginx-proxy",
"namespace": "jwilder",
"description": "Automated nginx reverse proxy.",
"pull_count": 9876543210,
"star_count": 8500,
"is_official": false
}
]
}