{"name":"Docker Hub Images API","description":"Docker Hub search results with repository name, description, publisher, pull count, stars, categories, architectures and link.","api_id":"generated_bbb6cb8ef88447e346571b55","slug":"docker-hub-images-api","source":{"name":"Docker Hub","domain":"hub.docker.com","url":"https://hub.docker.com/"},"category":"public_data","countries":[],"languages":["en"],"record_types":[],"tags":[],"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."],"updated":"2026-11-19","note":"Sample records are saved samples, not a live run. CleanedWeb is not affiliated with the source.","version":"1.0","versions":[{"major":1,"latest_minor":"1.0","status":"current","sunset_at":null}],"changelog":[{"version":"1.0","date":"2026-11-11T08:59:08.000Z","kind":"major","changes":[]}],"version_note":"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.","endpoints":[{"endpoint_id":"generated_bbb6cb8ef88447e346571b55_search","name":"Extract records","description":"Return records within the accepted scope.","definition_version":"f7bdee35602e5a128b8965731b0c84ae5665ad7e27ea84f94f9416e1dc083499","method":"POST","path":"/v1/catalog/public/apis/generated_bbb6cb8ef88447e346571b55/endpoints/generated_bbb6cb8ef88447e346571b55_search/run","url":"https://api.cleanedweb.com/v1/catalog/public/apis/generated_bbb6cb8ef88447e346571b55/endpoints/generated_bbb6cb8ef88447e346571b55_search/run","authentication":{"type":"bearer","scheme":"Authorization: Bearer <API key>","scope":"run","note":"Reading this file and the live catalog needs no credential. A run needs a CleanedWeb account and uses the credits of its workspace.","docs":"https://cleanedweb.com/docs/run-catalog-api/"},"required_headers":[{"name":"Authorization","value":"Bearer YOUR_API_KEY","description":"An API key with the run scope."},{"name":"Idempotency-Key","value":"UNIQUE_REQUEST_ID","description":"Required. Save it before you send; reuse it only to retry the same request and to read the result. 1-200 characters: letters, numbers, . _ : -"},{"name":"Content-Type","value":"application/json","description":"The body is JSON."}],"request_body":{"input":"An object that follows input_schema.","max_items":"Optional. Stop after this many records.","timeout_seconds":"Optional, 60-86400, default 10800.","wait_seconds":"Optional, 0-86400, default 90. How long the request waits before answering 202.","version":"Optional integer major. Leave it out for the latest major."},"input_schema":{"type":"object","properties":{"enrich_records":{"type":"boolean","default":true,"description":"true: read each returned record's product/detail page and merge its fields into the record. false: return list/search-level fields only, with no detail page reads. Every returned record's detail page is read within the run's time budget; records the time budget leaves unread are returned without detail fields, and summary.record_enrichment reports how many records were enriched and why any were not (run_time_budget). Detail fields are optional."},"search":{"type":"string","minLength":1,"maxLength":100,"pattern":"^[^\\x00-\\x1f\\x7f]+$","description":"Optional. Text sent to the site's own search form; its result pages are read and revalidated like the collection. Omit to use the default: authelia.","default":"authelia","x-source-key":"q"},"type":{"x-enum-labels":["image","Helm Charts","Sandbox Kits","AI Models","Compose"],"x-value-status":["observed","verified","verified","verified","observed"],"description":"Optional. One observed value of the site's own filter; the pasted page is read with only this value changed and revalidated like the collection. Omit for the pasted page.","x-source-key":"type","default":"image","type":"string","enum":["image","helm","sbx_kit","model","compose"]},"badges":{"x-enum-labels":["Docker Hardened Image","Docker Official Image","Verified Publisher","Sponsored OSS"],"x-value-status":["verified","verified","verified","observed"],"description":"Optional. One observed value of the site's own filter; the pasted page is read with only this value changed and revalidated like the collection. Omit for the pasted page.","x-source-key":"badges","type":"string","enum":["hardened","official","verified_publisher","open_source"]},"categories":{"x-enum-labels":["Networking","Security","Languages & frameworks","Integration & delivery","Message queues","API management","Internet of things","Machine learning & AI","Developer tools","Data science","Web servers","Operating systems","Content management system","Databases & storage","Monitoring & observability","Web analytics"],"x-value-status":["verified","observed","observed","observed","observed","verified","observed","observed","observed","observed","verified","observed","observed","observed","observed","observed"],"description":"Optional. One observed value of the site's own filter; the pasted page is read with only this value changed and revalidated like the collection. Omit for the pasted page.","x-source-key":"categories","type":"string","enum":["Networking","Security","Languages & frameworks","Integration & delivery","Message queues","API management","Internet of things","Machine learning & AI","Developer tools","Data science","Web servers","Operating systems","Content management system","Databases & storage","Monitoring & observability","Web analytics"]},"operating_system":{"x-enum-labels":["Linux","Windows"],"x-value-status":["verified","verified"],"description":"Optional. One observed value of the site's own filter; the pasted page is read with only this value changed and revalidated like the collection. Omit for the pasted page.","x-source-key":"operating_system","type":"string","enum":["linux","windows"]},"architecture":{"x-enum-labels":["x86-64","ARM","IBM Z","PowerPC 64 LE"],"x-value-status":["verified","observed","verified","observed"],"description":"Optional. One observed value of the site's own filter; the pasted page is read with only this value changed and revalidated like the collection. Omit for the pasted page.","x-source-key":"architecture","type":"string","enum":["amd64","arm","s390x","ppc64le"]},"sbx_supported":{"x-enum-labels":["Cloud"],"x-value-status":["verified"],"description":"Optional. One observed value of the site's own filter; the pasted page is read with only this value changed and revalidated like the collection. Omit for the pasted page. Applies only within type=sbx_kit: sent alone it selects type=sbx_kit too; with another type the call is refused.","x-source-key":"sbx_supported","type":"string","enum":["cloud"],"x-applies-with":{"input":"type","value":"sbx_kit"}},"sbx_kit_kind":{"x-enum-labels":["Sandbox/Workload","Mixin"],"x-value-status":["verified","verified"],"description":"Optional. One observed value of the site's own filter; the pasted page is read with only this value changed and revalidated like the collection. Omit for the pasted page. Applies only within type=sbx_kit: sent alone it selects type=sbx_kit too; with another type the call is refused.","x-source-key":"sbx_kit_kind","type":"string","enum":["workload","mixin"],"x-applies-with":{"input":"type","value":"sbx_kit"}},"sort":{"type":"string","enum":["updated_at","pull_count"],"x-enum-labels":{"updated_at":"Recently updated","pull_count":"Pull count"},"x-source-keys":["order","sort"],"x-value-status":"verified","x-combination":"unproven","description":"Order of the collection, as the site's own sort control offers it; omitted keeps the site's default order.","x-combinable-with":["search"]}},"required":[],"additionalProperties":false,"allOf":[{"anyOf":[{"not":{"required":["sbx_supported"]}},{"properties":{"type":{"anyOf":[{"const":"sbx_kit"},{"type":"array","items":{"const":"sbx_kit"},"minItems":1}]}}}]},{"anyOf":[{"not":{"required":["sbx_kit_kind"]}},{"properties":{"type":{"anyOf":[{"const":"sbx_kit"},{"type":"array","items":{"const":"sbx_kit"},"minItems":1}]}}}]}]},"output_schema":{"type":"object","properties":{"architectures_label":{"type":"array","items":{"type":"string"}},"architectures_name":{"type":"array","items":{"type":"string"}},"archived":{"type":"boolean"},"attestations":{"type":"boolean"},"badge":{"type":"string"},"categories_name":{"type":"array","items":{"type":"string"}},"categories_slug":{"type":"array","items":{"type":"string"}},"content_types":{"type":"array","items":{"type":"string"}},"created_at":{"type":"string"},"extension_reviewed":{"type":"boolean"},"id":{"type":"string"},"large":{"type":"string"},"media_types":{"type":"array","items":{"type":"string"}},"name":{"type":"string"},"publisher_id":{"type":"string"},"publisher_name":{"type":"string"},"pull_count":{"type":"string"},"short_description":{"type":"string"},"small":{"type":"string"},"star_count":{"type":"integer"},"systems_label":{"type":"array","items":{"type":"string"}},"systems_name":{"type":"array","items":{"type":"string"}},"type":{"type":"string"},"updated_at":{"type":"string"},"url":{"type":"string","format":"uri"},"is_hub_sbx_kits_enabled":{"type":"boolean"},"org_data_date_joined":{"type":"string"},"org_data_full_name":{"type":"string"},"org_data_is_active":{"type":"boolean"},"org_data_profile_url":{"type":"string"},"org_data_type":{"type":"string"},"org_data_uuid":{"type":"string"},"recent_tags_content_type":{"type":"array","items":{"type":["string","null"]}},"recent_tags_creator":{"type":"array","items":{"type":["integer","null"]}},"recent_tags_digest":{"type":"array","items":{"type":["string","null"]}},"recent_tags_full_size":{"type":"array","items":{"type":["integer","null"]}},"recent_tags_id":{"type":"array","items":{"type":["integer","null"]}},"recent_tags_last_updated":{"type":"array","items":{"type":["string","null"]}},"recent_tags_last_updater":{"type":"array","items":{"type":["integer","null"]}},"recent_tags_media_type":{"type":"array","items":{"type":["string","null"]}},"recent_tags_name":{"type":"array","items":{"type":["string","null"]}},"recent_tags_repository":{"type":"array","items":{"type":["integer","null"]}},"recent_tags_tag_last_pulled":{"type":"array","items":{"type":["string","null"]}},"recent_tags_tag_last_pushed":{"type":"array","items":{"type":["string","null"]}},"recent_tags_tag_status":{"type":"array","items":{"type":["string","null"]}},"recent_tags_v2":{"type":"array","items":{"type":["boolean","null"]}},"repo_collaborator_count":{"type":"integer"},"repo_full_description":{"type":"string"},"repo_hub_user":{"type":"string"},"repo_last_modified":{"type":"string"},"repo_name":{"type":"string"},"repo_pull_count":{"type":"integer"},"repo_status":{"type":"integer"},"repo_status_description":{"type":"string"},"repo_storage_size":{"type":"integer"},"reponame":{"type":"string"},"selected_tag_creator":{"type":"integer"},"selected_tag_digest":{"type":"string"},"selected_tag_full_size":{"type":"integer"},"selected_tag_id":{"type":"integer"},"selected_tag_last_updated":{"type":"string"},"selected_tag_last_updater":{"type":"integer"},"selected_tag_media_type":{"type":"string"},"selected_tag_name":{"type":"string"},"selected_tag_repository":{"type":"integer"},"selected_tag_tag_last_pulled":{"type":"string"},"selected_tag_tag_last_pushed":{"type":"string"},"selected_tag_tag_status":{"type":"string"},"selected_tag_v2":{"type":"boolean"}},"additionalProperties":true,"required":["url"]},"output_schema_note":"Some fields the source returns are not published here (identifiers, personal details and page-building noise). A record can carry fields this schema does not list, so additionalProperties is true. Do not reject a record for an extra field. The live contract, linked as live_contract, lists every field the saved definition declares.","examples":[{"kind":"saved_validation_records","saved_at":"2026-11-11T08:59:08.029Z","live_verified":false,"request":{"input":{}},"records_shown":3,"records_saved":3,"records":[{"name":"authelia/authelia","short_description":"The Cloud ready multi-factor authentication portal for your Apps https://www.authelia.com","publisher_name":"authelia","pull_count":"50M+","star_count":214,"updated_at":"2026-11-08T09:14:23.858242Z","url":"https://hub.docker.com/r/authelia/authelia"},{"name":"authelia/buildkite","short_description":"Dockerfile of the buildkite agent used to build Authelia","publisher_name":"authelia","pull_count":"100K+","star_count":0,"updated_at":"2026-11-06T02:07:54.863924Z","url":"https://hub.docker.com/r/authelia/buildkite"},{"name":"authelia/base","short_description":"Base GLIBC Container","publisher_name":"authelia","pull_count":"100K+","star_count":1,"updated_at":"2026-11-07T17:02:46.510014Z","url":"https://hub.docker.com/r/authelia/base"}]}],"request_example":{"body":{"input":{"type":"image"},"version":1,"max_items":25},"curl":"curl -X POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_bbb6cb8ef88447e346571b55/endpoints/generated_bbb6cb8ef88447e346571b55_search/run \\\n  -H \"Authorization: Bearer YOUR_API_KEY\" \\\n  -H \"Idempotency-Key: UNIQUE_REQUEST_ID\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"input\": {\n    \"type\": \"image\"\n  },\n  \"version\": 1,\n  \"max_items\": 25\n}'"},"result":{"method":"GET","url":"https://api.cleanedweb.com/v1/catalog/public/apis/generated_bbb6cb8ef88447e346571b55/endpoints/generated_bbb6cb8ef88447e346571b55_search/result","note":"A run that does not end within wait_seconds answers 202. Read the result with the same API key and the same Idempotency-Key."},"links":{"page":"https://cleanedweb.com/catalog/docker-hub-images-api/","markdown":"https://cleanedweb.com/catalog/docker-hub-images-api/index.md","live_contract":"https://app.cleanedweb.com/api/catalog/apis/generated_bbb6cb8ef88447e346571b55/endpoints/generated_bbb6cb8ef88447e346571b55_search/contract","run_docs":"https://cleanedweb.com/docs/run-catalog-api/"}}],"links":{"page":"https://cleanedweb.com/catalog/docker-hub-images-api/","markdown":"https://cleanedweb.com/catalog/docker-hub-images-api/index.md","contract":"https://cleanedweb.com/catalog/docker-hub-images-api/contract.json","catalog":"https://cleanedweb.com/catalog/","index":"https://cleanedweb.com/catalog/index.json","openapi":"https://cleanedweb.com/catalog/openapi.json"}}
