Docker Hub API

Search Docker Hub images and read repositories, tags, pull counts and vulnerability counts as JSON.

The API.SH Docker Hub API returns public Docker Hub data as JSON. Search images with the Hub's own filters (official, verified publisher, open source, category, architecture, OS), read a repository's description, stars, exact pull count, README and latest tags, list every tag with per-platform images and optional vulnerability counts, and look up a user or organization with its repositories.

Get a free API key Try it in the playground

5 endpoints
from $1 / 1,000 calls
1,000 free credits / month
failed calls free

Docker Hub image search

GET https://api.api.sh/dockerhub/v1/search

{ "success": true }

1 credit · $1 per 1,000 calls

What you can build with the Docker Hub API

Base image updates

List a repository's tags sorted by last updated, with digest and size per architecture, to know when to rebuild.

/tags

Image security checks

Read critical, high, medium and low vulnerability counts per platform image before you adopt a tag.

/tags /repository

Open-source adoption metrics

Track a repository's exact pull count and stars over time, or every repository of your organization, to measure usage.

/repository /namespace

Image discovery and catalogs

Search official or verified-publisher images by keyword, category, architecture and OS for an internal catalog or developer portal.

/search /categories

DevOps agents

Let an AI agent find the right image, read its README and pick a tag that supports your architecture.

/search /repository /tags

Docker Hub data you get

Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.

Docker Hub API endpoints and prices

Every Docker Hub endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing

Search and discovery1

Docker Hub image search

/dockerhub/v1/search

$1 · $2 PAYG

1 credit

Profiles and accounts1

Docker Hub user or organization

/dockerhub/v1/namespace

$1 · $2 PAYG

1 credit

More data3

Docker Hub categories /dockerhub/v1/categories	$1 · $2 PAYG 1 credit
Docker Hub repository /dockerhub/v1/repository	$1 · $2 PAYG 1 credit
Docker Hub repository tags /dockerhub/v1/tags	$1 · $2 PAYG 1 credit

Call the Docker Hub API

Docker Hub image search: GET https://api.api.sh/dockerhub/v1/search

curl "https://api.api.sh/dockerhub/v1/search?q=redis" \
  -H "x-api-key: $APISH_KEY"

import os, requests

res = requests.get(
    "https://api.api.sh/dockerhub/v1/search",
    params={"q": "redis"},
    headers={"x-api-key": os.environ["APISH_KEY"]},
    timeout=120,
)
res.raise_for_status()
data = res.json()

const url = new URL("https://api.api.sh/dockerhub/v1/search");
url.searchParams.set("q", "redis");

const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json();

# Google Sheets (API.SH add-on)
=APISH("/dockerhub/v1/search", "q", "redis")

# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "Docker Hub" and "Docker Hub image search".

# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp

Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
Create an API keyOne key works for all 483 platforms.
Send the requestJSON back in one call. Add output=csv or output=ndjson for files.

Why API.SH for Docker Hub data

Public data only: no Docker Hub login, cookies or account needed
One key and one response shape for Docker Hub and 482 other platforms
Built and maintained by API.SH, not third-party publishers
Pay per call; errors on our side cost nothing
Live status for every endpoint

API.SH vs the official Docker Hub API

Docker publishes the Docker Hub API (v2) and the Registry API, but the Hub's search and repository endpoints are thinly documented, rate limited and some need a token or a signed-in account. API.SH returns public search, repository, tag and vulnerability data as paged JSON with no Docker account or token.

Instead of scripting against undocumented hub.docker.com endpoints with curl and jq, or building a Docker Hub scraper, API.SH gives you search, tags and repository stats with one key and a fixed price per call.

Docker Hub API questions

What Docker Hub data can I get?+

Image search with filters (/dockerhub/v1/search), the category list for that filter (/dockerhub/v1/categories), one repository with stars, pulls, README and latest tags (/dockerhub/v1/repository), all tags with per-platform images and vulnerability counts (/dockerhub/v1/tags), and a user or organization with its repositories (/dockerhub/v1/namespace).

How much does the Docker Hub API cost?+

Every Docker Hub endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.

Is there a free trial?+

Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /dockerhub/v1/categories at 1 credit each.

Is there an official Docker Hub API?+

Yes. Docker documents the Docker Hub API v2 and the Registry API. Parts of the Hub API are poorly documented and rate limited, and personal access tokens mainly cover the Registry API. API.SH gives you the public data in one JSON shape without tokens.

Do I need a Docker Hub account or access token?+

No. API.SH reads public Docker Hub data only. No endpoint uses a Docker login, token or private repository.

How do I get all tags of a Docker Hub image?+

Call /dockerhub/v1/tags with name=nginx (or namespace/repo). Pass next_page back as page until it is null; sort by last_updated or name and filter by q.

Can I use the Docker Hub API from Python?+

Yes. Use the API.SH Python SDK or any HTTP client: call /dockerhub/v1/repository with a name and read the JSON.

How do I get started?+

1. Sign up at api.sh. 2. Copy your API key. 3. Call /dockerhub/v1/repository with a name such as nginx. Request examples and every parameter are in the docs at https://api.sh/docs. You can also use the JS or Python SDK, Google Sheets, Zapier, Make, n8n or the MCP server at https://api.sh/mcp.