{"openapi":"3.1.0","info":{"title":"Docker Hub API","version":"1.0.0","description":"The container image registry — Docker Hub — as an API. Look up any image (repository) for its description, total pull count and star count, official status, last-updated date and categories, plus the ready-to-run `docker pull` command; list an image's tags and versions with each tag's compressed size, supported platforms (linux/amd64, linux/arm64, …) and publish date; and search the registry of millions of images. Covers everything from official images like nginx, postgres, redis, node, python and ubuntu to vendor images like bitnami/postgresql. Live from the official hub.docker.com API. Ideal for DevOps dashboards, CI/CD and supply-chain tooling, image catalogs and update automation. Open data from Docker Hub.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/docker-api","description":"oanor gateway"}],"tags":[{"name":"Docker Hub"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/image":{"get":{"operationId":"get_v1_image","tags":["Docker Hub"],"summary":"Image (repository) metadata","description":"","parameters":[{"name":"name","in":"query","required":true,"description":"Image name, e.g. nginx or bitnami/postgresql","schema":{"type":"string"},"example":"nginx"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"image":{"name":"nginx","status":"active","full_name":"library/nginx","namespace":"library","categories":["Web servers"],"docker_url":"https://hub.docker.com/_/nginx","pull_count":13047598322,"star_count":21287,"description":"Official build of Nginx.","is_official":true,"last_updated":"2026-05-24T19:52:26.039369Z","pull_command":"docker pull nginx","canonical_name":"nginx","date_registered":"2014-06-05T19:14:45Z"}},"meta":{"timestamp":"2026-05-31T14:24:44.932Z","request_id":"c8358e8e-2f9b-4bed-bc73-743777cc2c76"},"status":"ok","message":"Image retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Docker Hub"],"summary":"Search the registry","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Search term","schema":{"type":"string"},"example":"postgres"},{"name":"limit","in":"query","required":false,"description":"Results (1-100, default 20)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":20,"query":"postgres","total":51392,"results":[{"name":"postgres","docker_url":"https://hub.docker.com/_/postgres","pull_count":10726279840,"star_count":14917,"description":"The PostgreSQL object-relational database system provides reliability and data integrity.","is_official":true,"is_automated":false,"pull_command":"docker pull postgres"},{"name":"cimg/postgres","docker_url":"https://hub.docker.com/r/cimg/postgres","pull_count":670452093,"star_count":9,"is_official":false,"is_automated":false,"pull_command":"docker pull cimg/postgres"},{"name":"circleci/postgres","docker_url":"https://hub.docker.com/r/circleci/postgres","pull_count":509423944,"star_count":35,"description":"The PostgreSQL object-relational database system provides reliability and data integrity.","is_official":false,"is_automated":false,"pull_command":"docker pull circleci/postgres"},{"name":"kasmweb/postgres","docker_url":"https://hub.docker.com/r/kasmweb/postgres","pull_count":662161,"star_count":6,"description":"Postgres image maintained by Kasm Technologies that includes pg_audit and other modifications.","is_official":false,"is_automated":false,"pull_command":"docker pull kasmweb/postgres"},{"name":"elestio/postgres","docker_url":"https://hub.docker.com/r/elestio/postgres","pull_count":190650,"star_count":2,"description":"Postgres, verified and packaged by Elestio","is_official":false,"is_automated":false,"pull_command":"docker pull elestio/postgres"},{"name":"ubuntu/postgres","docker_url":"https://hub.docker.com/r/ubuntu/postgres","pull_count":853604,"star_count":44,"description":"PostgreSQL is an open source object-relational database. Long-term versions maintained by Canonical.","is_official":false,"is_automated":false,"pull_command":"docker pull ubuntu/postgres"},{"name":"cleanstart/postgres","docker_url":"https://hub.docker.com/r/cleanstart/postgres","pull_count":37071,"star_count":0,"description":"Secure by Design, Built for Speed, Hardened Container Images on a minimal base CleanStart OS.","is_official":false,"is_automated":false,"pull_command":"docker pull cleanstart/postgres"},{"name":"artifacthub/postgres","docker_url":"https://hub.docker.com/r/artifacthub/postgres","pull_count":688446,"star_count":0,"is_official":false,"is_automated":false,"pull_command":"docker pull artifacthub/postgres"},{"name":"geokrety/postgres","docker_url":"https://hub.docker.com/r/geokrety/postgres","pull_count":20968,"star_count":0,"description":"Postgres with postgis + quantile and amqp extensions.","is_official":false,"is_automated":false,"pull_command":"docker pull geokrety/postgres"},{"name":"corpusops/postgres","docker_url":"https://hub.docker.com/r/corpusops/postgres","pull_count":258922,"star_count":0,"description":"https://github.com/corpusops/docker-images/","is_official":false,"is_automated":false,"pull_command":"docker pull corpusops/postgres"},{"name":"rootpublic/postgres","docker_url":"https://hub.docker.com/r/rootpublic/postgres","pull_count":4788,"star_count":0,"is_official":false,"is_automated":false,"pull_command":"docker pull rootpublic/postgres"},{"name":"dockette/postgres","docker_url":"https://hub.docker.com/r/dockette/postgres","pull_count":71432,"star_count":1,"description":"My PostgreSQL image with tunning and preinstalled extensions (unaccent)","is_official":false,"is_automated":false,"pull_command":"docker pull dockette/postgres"},{"name":"vulhub/postgres","docker_url":"https://hub.docker.com/r/vulhub/postgres","pull_count":50422,"star_count":1,"is_official":false,"is_automated":false,"pull_command":"docker pull vulhub/postgres"},{"name":"wayofdev/postgres","docker_url":"https://hub.docker.com/r/wayofdev/postgres","pull_count":7791,"star_count":0,"is_official":false,"is_automated":false,"pull_command":"docker pull wayofdev/postgres"},{"name":"pgrouting/postgres","docker_url":"https://hub.docker.com/r/pgrouting/postgres","pull_count":360,"star_count":0,"description":"Postgres Docker images with PostGIS and dependencies to build pgRouting images.","is_official":false,"is_automated":false,"pull_command":"docker pull pgrouting/postgres"},{"name":"uselagoon/postgres","docker_url":"https://hub.docker.com/r/uselagoon/postgres","pull_count":1192,"star_count":0,"is_official":false,"is_automated":false,"pull_command":"docker pull uselagoon/postgres"},{"name":"openeuler/postgres","docker_url":"https://hub.docker.com/r/openeuler/postgres","pull_count":1014,"star_count":0,"is_official":false,"is_automated":false,"pull_command":"docker pull openeuler/postgres"},{"name":"clarinpl/postgres","docker_url":"https://hub.docker.com/r/clarinpl/postgres","pull_count":167,"star_count":0,"is_official":false,"is_automated":false,"pull_command":"docker pull clarinpl/postgres"},{"name":"supabase/postgres","docker_url":"https://hub.docker.com/r/supabase/postgres","pull_count":12061490,"star_count":77,"description":"Unmodified Postgres with some useful plugins.","is_official":false,"is_automated":false,"pull_command":"docker pull supabase/postgres"},{"name":"mosipdev/postgres","docker_url":"https://hub.docker.com/r/mosipdev/postgres","pull_count":26,"star_count":0,"is_official":false,"is_automated":false,"pull_command":"docker pull mosipdev/postgres"}]},"meta":{"timestamp":"2026-05-31T14:24:45.198Z","request_id":"1d78a630-63af-4aea-9ffc-1aab6e77a3e8"},"status":"ok","message":"Images searched","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/tags":{"get":{"operationId":"get_v1_tags","tags":["Docker Hub"],"summary":"Image tags / versions","description":"","parameters":[{"name":"name","in":"query","required":true,"description":"Image name, e.g. redis","schema":{"type":"string"},"example":"redis"},{"name":"limit","in":"query","required":false,"description":"Max tags (1-100, default 25)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"tags":[{"name":"trixie","size":54269113,"digest":"sha256:aa049e689e141a4358ad1d4562dc49c88a89fbab711fd8fcc33f684c80b26301","platforms":["linux/386","linux/ppc64le","linux/amd64","linux/arm/v5","linux/arm/v7","linux/arm64/v8","linux/riscv64","linux/s390x"],"last_updated":"2026-05-28T21:06:02.626978Z"},{"name":"latest","size":54269113,"digest":"sha256:aa049e689e141a4358ad1d4562dc49c88a89fbab711fd8fcc33f684c80b26301","platforms":["linux/s390x","linux/amd64","linux/arm/v5","linux/arm/v7","linux/arm64/v8","linux/386","linux/ppc64le","linux/riscv64"],"last_updated":"2026-05-28T21:05:59.672296Z"},{"name":"8.8.0-trixie","size":54269113,"digest":"sha256:aa049e689e141a4358ad1d4562dc49c88a89fbab711fd8fcc33f684c80b26301","platforms":["linux/amd64","linux/arm/v5","linux/arm/v7","linux/arm64/v8","linux/386","linux/ppc64le","linux/riscv64","linux/s390x"],"last_updated":"2026-05-28T21:05:54.136287Z"},{"name":"8.8.0","size":54269113,"digest":"sha256:aa049e689e141a4358ad1d4562dc49c88a89fbab711fd8fcc33f684c80b26301","platforms":["linux/amd64","linux/arm/v5","linux/arm/v7","linux/arm64/v8","linux/386","linux/ppc64le","linux/riscv64","linux/s390x"],"last_updated":"2026-05-28T21:05:48.225695Z"},{"name":"8.8-trixie","size":54269113,"digest":"sha256:aa049e689e141a4358ad1d4562dc49c88a89fbab711fd8fcc33f684c80b26301","platforms":["linux/amd64","linux/arm/v5","linux/arm/v7","linux/arm64/v8","linux/386","linux/ppc64le","linux/riscv64","linux/s390x"],"last_updated":"2026-05-28T21:05:45.177339Z"},{"name":"8.8","size":54269113,"digest":"sha256:aa049e689e141a4358ad1d4562dc49c88a89fbab711fd8fcc33f684c80b26301","platforms":["linux/amd64","linux/arm/v5","linux/arm/v7","linux/arm64/v8","linux/386","linux/ppc64le","linux/riscv64","linux/s390x"],"last_updated":"2026-05-28T21:05:39.30386Z"},{"name":"8-trixie","size":54269113,"digest":"sha256:aa049e689e141a4358ad1d4562dc49c88a89fbab711fd8fcc33f684c80b26301","platforms":["linux/ppc64le","linux/riscv64","linux/s390x","linux/amd64","linux/arm/v5","linux/arm/v7","linux/arm64/v8","linux/386"],"last_updated":"2026-05-28T21:05:03.285185Z"},{"name":"8","size":54269113,"digest":"sha256:aa049e689e141a4358ad1d4562dc49c88a89fbab711fd8fcc33f684c80b26301","platforms":["linux/amd64","linux/arm/v5","linux/arm/v7","linux/arm64/v8","linux/386","linux/ppc64le","linux/riscv64","linux/s390x"],"last_updated":"2026-05-28T21:04:56.491249Z"},{"name":"alpine3.23","size":37645256,"digest":"sha256:09160599abd229764c0fb44cb6be640294e1d360a54b19985ab4843dcf2d90f1","platforms":["linux/amd64","linux/arm/v6","linux/arm/v7","linux/arm64/v8","linux/386","linux/ppc64le","linux/riscv64","linux/s390x"],"last_updated":"2026-05-28T12:05:54.627124Z"},{"name":"alpine","size":37645256,"digest":"sha256:09160599abd229764c0fb44cb6be640294e1d360a54b19985ab4843dcf2d90f1","platforms":["linux/amd64","linux/arm/v6","linux/arm/v7","linux/arm64/v8","linux/386","linux/ppc64le","linux/riscv64","linux/s390x"],"last_updated":"2026-05-28T12:05:51.715042Z"},{"name":"8.8.0-alpine3.23","size":37645256,"digest":"sha256:09160599abd229764c0fb44cb6be640294e1d360a54b19985ab4843dcf2d90f1","platforms":["linux/amd64","linux/arm/v6","linux/arm/v7","linux/arm64/v8","linux/386","linux/ppc64le","linux/riscv64","linux/s390x"],"last_updated":"2026-05-28T12:05:47.628758Z"},{"name":"8.8.0-alpine","size":37645256,"digest":"sha256:09160599abd229764c0fb44cb6be640294e1d360a54b19985ab4843dcf2d90f1","platforms":["linux/amd64","linux/arm/v6","linux/arm/v7","linux/arm64/v8","linux/386","linux/ppc64le","linux/riscv64","linux/s390x"],"last_updated":"2026-05-28T12:05:44.697188Z"},{"name":"8.8-alpine3.23","size":37645256,"digest":"sha256:09160599abd229764c0fb44cb6be640294e1d360a54b19985ab4843dcf2d90f1","platforms":["linux/amd64","linux/arm/v6","linux/arm/v7","linux/arm64/v8","linux/386","linux/ppc64le","linux/riscv64","linux/s390x"],"last_updated":"2026-05-28T12:05:39.388497Z"},{"name":"8.8-alpine","size":37645256,"digest":"sha256:09160599abd229764c0fb44cb6be640294e1d360a54b19985ab4843dcf2d90f1","platforms":["linux/amd64","linux/arm/v6","linux/arm/v7","linux/arm64/v8","linux/386","linux/ppc64le","linux/riscv64","linux/s390x"],"last_updated":"2026-05-28T12:05:36.235659Z"},{"name":"8-alpine3.23","size":37645256,"digest":"sha256:09160599abd229764c0fb44cb6be640294e1d360a54b19985ab4843dcf2d90f1","platforms":["linux/amd64","linux/arm/v6","linux/arm/v7","linux/arm64/v8","linux/386","linux/ppc64le","linux/riscv64","linux/s390x"],"last_updated":"2026-05-28T12:04:59.174345Z"},{"name":"8-alpine","size":37645256,"digest":"sha256:09160599abd229764c0fb44cb6be640294e1d360a54b19985ab4843dcf2d90f1","platforms":["linux/amd64","linux/arm/v6","linux/arm/v7","linux/arm64/v8","linux/386","linux/ppc64le","linux/riscv64","linux/s390x"],"last_updated":"2026-05-28T12:04:56.095135Z"},{"name":"8.8-rc1-trixie","size":54248864,"digest":"sha256:537e53449c58e35ac668f6b24f0bf4c5b0e93f0fdc16db3730a567553b40734d","platforms":["linux/amd64","linux/arm/v5","linux/arm/v7","linux/arm64/v8","linux/386","linux/ppc64le","linux/riscv64","linux/s390x"],"last_updated":"2026-05-24T21:05:39.221178Z"},{"name":"8.8-rc1-alpine3.23","size":37634965,"digest":"sha256:d15f5c0d45aa9fa1138797019117b5189c22f3a3408d73585aadf3c7e7de4d49","platforms":["linux/amd64","linux/arm/v6","linux/arm/v7","linux/arm64/v8","linux/386","linux/ppc64le","linux/riscv64","linux/s390x"],"last_updated":"2026-05-24T21:05:36.291398Z"},{"name":"8.8-rc1-alpine","size":37634965,"digest":"sha256:d15f5c0d45aa9fa1138797019117b5189c22f3a3408d73585aadf3c7e7de4d49","platforms":["linux/amd64","linux/arm/v6","linux/arm/v7","linux/arm64/v8","linux/386","linux/ppc64le","linux/riscv64","linux/s390x"],"last_updated":"2026-05-24T21:05:33.194303Z"},{"name":"8.8-rc1","size":54248864,"digest":"sha256:537e53449c58e35ac668f6b24f0bf4c5b0e93f0fdc16db3730a567553b40734d","platforms":["linux/amd64","linux/arm/v5","linux/arm/v7","linux/arm64/v8","linux/386","linux/ppc64le","linux/riscv64","linux/s390x"],"last_updated":"2026-05-24T21:05:27.541056Z"},{"name":"8.6.3-trixie","size":53282607,"digest":"sha256:4d25e2fe601f7ffaeb4437cb6ced3518bc36edf34ebe98863c80836943d94529","platforms":["linux/amd64","linux/arm/v5","linux/arm/v7","linux/arm64/v8","linux/386","linux/ppc64le","linux/riscv64","linux/s390x"],"last_updated":"2026-05-21T15:05:50.279904Z"},{"name":"8.6.3","size":53282607,"digest":"sha256:4d25e2fe601f7ffaeb4437cb6ced3518bc36edf34ebe98863c80836943d94529","platforms":["linux/amd64","linux/arm/v5","linux/arm/v7","linux/arm64/v8","linux/386","linux/ppc64le","linux/riscv64","linux/s390x"],"last_updated":"2026-05-21T15:05:44.9561Z"},{"name":"8.6-trixie","size":53282607,"digest":"sha256:4d25e2fe601f7ffaeb4437cb6ced3518bc36edf34ebe98863c80836943d94529","platforms":["linux/amd64","linux/arm/v5","linux/arm/v7","linux/arm64/v8","linux/386","linux/ppc64le","linux/riscv64","linux/s390x"],"last_updated":"2026-05-21T15:05:42.038844Z"},{"name":"8.6","size":53282607,"digest":"sha256:4d25e2fe601f7ffaeb4437cb6ced3518bc36edf34ebe98863c80836943d94529","platforms":["linux/amd64","linux/arm/v5","linux/arm/v7","linux/arm64/v8","linux/386","linux/ppc64le","linux/riscv64","linux/s390x"],"last_updated":"2026-05-21T15:05:36.414781Z"},{"name":"8.4.3-trixie","size":52867353,"digest":"sha256:b69f2ae9adef7d679fc7cace28e1d4d7e0359b1341861a55995aef5d1b285166","platforms":["linux/amd64","linux/arm/v5","linux/arm/v7","linux/arm64/v8","linux/386","linux/ppc64le","linux/riscv64","linux/s390x"],"last_updated":"2026-05-21T15:05:33.49919Z"}],"count":25,"image":"library/redis","total":1092},"meta":{"timestamp":"2026-05-31T14:24:45.455Z","request_id":"6936b68f-8847-45b6-915b-88520c257538"},"status":"ok","message":"Tags retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Source & options","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Live Docker Hub data. /v1/image = repository metadata (pull count, stars, description, official flag) + the docker-pull command; /v1/tags = image tags/versions with size, platforms and last-updated; /v1/search = search the registry. Bare names (e.g. nginx) are treated as official library images; use namespace/name (e.g. bitnami/postgresql) for user images.","source":"Docker Hub — the container image registry (hub.docker.com)","endpoints":["/v1/image","/v1/tags","/v1/search","/v1/meta"]},"meta":{"timestamp":"2026-05-31T14:24:45.531Z","request_id":"21a9b0da-7a42-4044-8c33-08bd48f43a05"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":3700,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":455,"monthly_call_quota":49900,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1355,"monthly_call_quota":244000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3565,"monthly_call_quota":1216000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/docker-api"}