Docker Hub
Overview
Container image registry. Public REST API for searching and browsing Docker images, tags, and metadata.
Workflows
Find a container image
searchImages(query) → repo_name (format: namespace/name)getImage(namespace, name) → full description, stars, pull count
Check available versions/tags
searchImages(query) → repo_name → split into namespace, namegetTags(namespace, name) → tags with size, architecture, last updated
Inspect an official image
getImage("library", name) → image detail (official images use "library" namespace)getTags("library", name) → available tags
Operations
| Operation |
Intent |
Key Input |
Key Output |
Notes |
| searchImages |
find container images |
query |
repo_name, short_description, star_count, pull_count, is_official |
entry point, paginated |
| getImage |
image details |
namespace, name <- searchImages |
description, full_description, star_count, pull_count, last_updated |
use "library" for official images |
| getTags |
list image tags/versions |
namespace, name <- searchImages |
name, full_size, images[].architecture, last_updated |
paginated, orderable |
Quick Start
# Search for images
openweb docker-hub exec searchImages '{"query":"nginx"}'
# Get details for an official image (namespace = "library")
openweb docker-hub exec getImage '{"namespace":"library","name":"nginx"}'
# Get details for a user image
openweb docker-hub exec getImage '{"namespace":"bitnami","name":"nginx"}'
# List tags for an image
openweb docker-hub exec getTags '{"namespace":"library","name":"python","page_size":10}'
# List tags sorted by most recently updated
openweb docker-hub exec getTags '{"namespace":"library","name":"node","ordering":"-last_updated","page_size":25}'
Known Issues
- Official images require
library as the namespace parameter.
- Search results use
repo_name which may be library/nginx or user/repo format.
- Tag
full_size may be 0 for multi-arch manifests; check images[].size for per-architecture sizes.
- Pagination defaults vary: search defaults to 25, tags defaults to 10.
1---2name: docker-hub3description: Docker Hub4---5# Docker Hub67## Overview8Container image registry. Public REST API for searching and browsing Docker images, tags, and metadata.910## Workflows1112### Find a container image131. `searchImages(query)` → `repo_name` (format: namespace/name)142. `getImage(namespace, name)` → full description, stars, pull count1516### Check available versions/tags171. `searchImages(query)` → `repo_name` → split into `namespace`, `name`182. `getTags(namespace, name)` → tags with size, architecture, last updated1920### Inspect an official image211. `getImage("library", name)` → image detail (official images use "library" namespace)222. `getTags("library", name)` → available tags2324## Operations2526| Operation | Intent | Key Input | Key Output | Notes |27|-----------|--------|-----------|------------|-------|28| searchImages | find container images | query | repo_name, short_description, star_count, pull_count, is_official | entry point, paginated |29| getImage | image details | namespace, name <- searchImages | description, full_description, star_count, pull_count, last_updated | use "library" for official images |30| getTags | list image tags/versions | namespace, name <- searchImages | name, full_size, images[].architecture, last_updated | paginated, orderable |3132## Quick Start3334```bash35# Search for images36openweb docker-hub exec searchImages '{"query":"nginx"}'3738# Get details for an official image (namespace = "library")39openweb docker-hub exec getImage '{"namespace":"library","name":"nginx"}'4041# Get details for a user image42openweb docker-hub exec getImage '{"namespace":"bitnami","name":"nginx"}'4344# List tags for an image45openweb docker-hub exec getTags '{"namespace":"library","name":"python","page_size":10}'4647# List tags sorted by most recently updated48openweb docker-hub exec getTags '{"namespace":"library","name":"node","ordering":"-last_updated","page_size":25}'49```5051## Known Issues52- Official images require `library` as the namespace parameter.53- Search results use `repo_name` which may be `library/nginx` or `user/repo` format.54- Tag `full_size` may be 0 for multi-arch manifests; check `images[].size` for per-architecture sizes.55- Pagination defaults vary: search defaults to 25, tags defaults to 10.
spike-faye-lei