# Docker Hub Images API

> Docker Hub search results with repository name, description, publisher, pull count, stars, categories, architectures and link.

- Page: https://cleanedweb.com/catalog/docker-hub-images-api/
- Contract (JSON): https://cleanedweb.com/catalog/docker-hub-images-api/contract.json
- Source: hub.docker.com (https://hub.docker.com/)
- Category: Public data
- Languages: English
- Updated: 2026-11-19

## About

Docker Hub is the public registry for container images. This API reads its search results and returns a record for each repository: its name, short description, publisher, pull count, stars, categories, supported architectures, last update and link.

Search text, content type (image, Helm chart, model, Compose), badge (official, verified publisher, open source), category, operating system, architecture and sort order are inputs, so one run can follow one search.

## Typical uses

- Compare images for the same tool by pulls and stars.
- List the official or verified images in a category.
- Watch when the images you depend on were last updated.

## Limitations

- Send your own search word: without one this API searches its default, authelia.
- Pull counts are rounded text, such as "50M+"; stars are a number.

A run reads until the source ends or your `max_items`, `timeout_seconds` or budget stops it.

## Key fields

| Field | Type | Sample value |
| --- | --- | --- |
| `name` | string | `authelia/authelia` |
| `short_description` | string | `The Cloud ready multi-factor authentication portal for your Apps https://www.au…` |
| `publisher_name` | string | `authelia` |
| `pull_count` | string | `50M+` |
| `star_count` | integer | `214` |
| `updated_at` | string | `2026-11-08T09:14:23.858242Z` |
| `url` | string | `https://hub.docker.com/r/authelia/authelia` |

Sample values come from one saved record, not a live run. Every field with its type, and the schemas, are in https://cleanedweb.com/catalog/docker-hub-images-api/contract.json. Some fields the source returns are not published, so a record can carry fields the schema does not list.

## Inputs

- `search` (string): Optional. Text for the site's search box. Leave it out to use the default: authelia.
- `type` (string): Optional. Filters by the site's type control. Default: image. Options: image, Helm Charts (helm), Sandbox Kits (sbx_kit), AI Models (model), Compose (compose).
- `badges` (string): Optional. Filters by the site's badges control. Options: Docker Hardened Image (hardened), Docker Official Image (official), Verified Publisher (verified_publisher), Sponsored OSS (open_source).
- `categories` (string): Optional. Filters by the site's categories control. Options: Networking, Security, Languages & frameworks, Integration & delivery, Message queues, API management, Internet of things, Machine learning & AI, and 8 more in https://cleanedweb.com/catalog/docker-hub-images-api/contract.json.
- `operating_system` (string): Optional. Filters by the site's operating system control. Options: Linux (linux), Windows (windows).
- `architecture` (string): Optional. Filters by the site's architecture control. Options: x86-64 (amd64), ARM (arm), IBM Z (s390x), PowerPC 64 LE (ppc64le).
- `sbx_supported` (string): Optional. Filters by the site's sbx supported control. Options: Cloud (cloud).
- `sbx_kit_kind` (string): Optional. Filters by the site's sbx kit kind control. Options: Sandbox/Workload (workload), Mixin (mixin).
- `sort` (string): Order of the collection, as the site's own sort control offers it; omitted keeps the site's default order. Options: Recently updated (updated_at), Pull count (pull_count).

`enrich_records` is on by default and adds the fields that only appear on each record's detail page. Send `false` to read list fields only. See https://cleanedweb.com/docs/run-api/

## Request

`POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_bbb6cb8ef88447e346571b55/endpoints/generated_bbb6cb8ef88447e346571b55_search/run`

```bash
curl -X POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_bbb6cb8ef88447e346571b55/endpoints/generated_bbb6cb8ef88447e346571b55_search/run \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: UNIQUE_REQUEST_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "type": "image"
  },
  "version": 1,
  "max_items": 25
}'
```

Send an `Idempotency-Key` header with every run and save it before you send. Reuse it only to retry the same request. If the run does not end within `wait_seconds`, read the result with the same API key and key:

`GET https://api.cleanedweb.com/v1/catalog/public/apis/generated_bbb6cb8ef88447e346571b55/endpoints/generated_bbb6cb8ef88447e346571b55_search/result`

## Versions

Current: `1.0`. Pin a major with "version": N in the run body (an integer). Leave it out and the call runs on the latest major. A sunset major runs on the latest major and the response says rerouted. An unknown major answers 404 catalog_version_not_found and lists the available majors.

- v1: current, newest minor `1.0`

### Changelog

- `1.0` (major) 2026-11-11

The same changelog, as data, is in https://cleanedweb.com/catalog/docker-hub-images-api/contract.json

## Use it from an AI agent

MCP server: https://api.cleanedweb.com/mcp?profile=catalog (Streamable HTTP). Sign in with a CleanedWeb account when the client asks (OAuth), or send an API key with the `read` and `run` scopes as `Authorization: Bearer`. Call `get_api` with `api_id` `generated_bbb6cb8ef88447e346571b55`, then `run_api` with the `run_with` arguments it returns. See https://cleanedweb.com/docs/mcp/

## Run it

Reading the catalog needs no credential. Running needs a CleanedWeb account and an API key with the `run` scope; the first 5,000 records are free, then $1 per 1,000 records. See https://cleanedweb.com/docs/run-catalog-api/

CleanedWeb is not affiliated with Docker Hub.
