About this API
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.
What you get
| 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 | hub.docker.com/r/authelia/authelia |
All 69 fields
Key fields
nameshort_descriptionpublisher_namepull_countstar_countupdated_aturl
Technical fields
architectures_labelarchitectures_namearchivedattestationsbadgecategories_namecategories_slugcontent_typescreated_atextension_reviewedidlargemedia_typespublisher_idsmallsystems_labelsystems_nametypeis_hub_sbx_kits_enabledorg_data_date_joinedorg_data_full_nameorg_data_is_activeorg_data_profile_urlorg_data_typeorg_data_uuidrecent_tags_content_typerecent_tags_creatorrecent_tags_digestrecent_tags_full_sizerecent_tags_idrecent_tags_last_updatedrecent_tags_last_updaterrecent_tags_media_typerecent_tags_namerecent_tags_repositoryrecent_tags_tag_last_pulledrecent_tags_tag_last_pushedrecent_tags_tag_statusrecent_tags_v2repo_collaborator_countrepo_full_descriptionrepo_hub_userrepo_last_modifiedrepo_namerepo_pull_countrepo_statusrepo_status_descriptionrepo_storage_sizereponameselected_tag_creatorselected_tag_digestselected_tag_full_sizeselected_tag_idselected_tag_last_updatedselected_tag_last_updaterselected_tag_media_typeselected_tag_nameselected_tag_repositoryselected_tag_tag_last_pulledselected_tag_tag_last_pushedselected_tag_tag_statusselected_tag_v2
Every field with its type, and the schemas, are in contract.json.
Sample records
3 saved records. This is a saved sample, not a live run.
name |
short_description |
publisher_name |
pull_count |
star_count |
updated_at |
|---|---|---|---|---|---|
| authelia/authelia | The Cloud ready multi-factor authentication portal for your Apps https://www.au… | authelia | 50M+ | 214 | 2026-11-08T09:14:23.858242Z |
| authelia/buildkite | Dockerfile of the buildkite agent used to build Authelia | authelia | 100K+ | 0 | 2026-11-06T02:07:54.863924Z |
| authelia/base | Base GLIBC Container | authelia | 100K+ | 1 | 2026-11-07T17:02:46.510014Z |
Scroll sideways to see more columns.
Inputs
-
searchstringOptional. Text for the site's search box. Leave it out to use the default: authelia.
-
typechoiceOptional. Filters by the site's type control. Default: image.
-
badgeschoiceOptional. Filters by the site's badges control.
-
categorieschoiceOptional. Filters by the site's categories control.
-
operating_systemchoiceOptional. Filters by the site's operating system control.
-
architecturechoiceOptional. Filters by the site's architecture control.
-
sbx_supportedchoiceOptional. Filters by the site's sbx supported control.
-
sbx_kit_kindchoiceOptional. Filters by the site's sbx kit kind control.
-
sortchoiceOrder of the collection, as the site's own sort control offers it; omitted keeps the site's default order.
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 Run an API.
Request
POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_bbb6cb8ef88447e346571b55/endpoints/generated_bbb6cb8ef88447e346571b55_search/run
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
}'
Save the Idempotency-Key before you send, and reuse it only to retry the same request. The key needs the run scope. See Run a catalog API.
version pins major v1, whose newest minor (1.0) answers. Leave it out and the call runs on the latest major.
Changelog
-
v1.0 (major) ·
Use it from an AI agent
Open in your coding agent
Add CleanedWeb to your agent as an MCP server, such as a custom connector in Claude or ChatGPT, then sign in with your CleanedWeb account. The agent can then find this API, run it and read the records. An API key with the read and run scopes works too.
https://api.cleanedweb.com/mcp?profile=catalog
Then ask, for example: Use CleanedWeb to get 25 records from the Docker Hub Images API.
The agent calls get_api with generated_bbb6cb8ef88447e346571b55, then run_api. Runs are charged like any other run. See Connect an MCP client.
Coverage
- Category
- Public data
- Languages
- English
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.
Reach. A run reads until the source ends or your max_items, timeout_seconds or budget stops it.
CleanedWeb is not affiliated with Docker Hub.