--- type: "firecrawl-provider" description: "Docker Hub, the public container image registry: catalog search with badge, architecture, OS and category filters; repository metadata and README; tag listings and tag detail with per-architecture digests, sizes and push dates; a namespace's repositories and profile; catalog categories; Docker Scout vulnerability summaries by image digest." use_when: "Docker Hub, the public container image registry: catalog search with badge, architecture, OS and category filters; repository metadata and README; tag listings and tag detail with per-architecture digests, sizes and push dates; a namespace's repositories and profile; catalog categories; Docker Scout vulnerability summaries by image digest." categories: "Developer" capabilities: 8 credits_per_call: 5 --- # Docker Hub on Firecrawl Alexandria Docker Hub, the public container image registry: catalog search with badge, architecture, OS and category filters; repository metadata and README; tag listings and tag detail with per-architecture digests, sizes and push dates; a namespace's repositories and profile; catalog categories; Docker Scout vulnerability summaries by image digest. - Categories: Developer - Category index: [Developer category](https://firecrawl.dev/alexandria/agents/categories/developer) - Provider key: `hub-docker-com` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://firecrawl.dev/app/alexandria/hub-docker-com) - [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/hub-docker-com/openapi.json) ## Capabilities - [Get image vulnerability summary](https://firecrawl.dev/alexandria/agents/providers/hub-docker-com/container-images/get_image_vulnerability_summary): Docker Scout's public vulnerability summary for image digests of a Docker Hub repository (`api.scout.docker.com/v1/graphql`, query `imageSummariesByDigest`): per digest the SBOM indexing state and the count of critical, high, medium, low and unspecified CVEs. Digests come from `list_tags`/`get_tag` (`images[].digest`). Digests Scout has not indexed are listed in `missing_digests`; when none of the requested digests is known the call is `not_found`. - [Get namespace](https://firecrawl.dev/alexandria/agents/providers/hub-docker-com/container-images/get_namespace): Public profile of a Docker Hub namespace from `/v2/orgs/{namespace}/` (which also answers for individual users): type (Organization or User), display name, company, location, profile link, join date, avatar and, for organizations, the verified-publisher badge and active flag. - [Get repository](https://firecrawl.dev/alexandria/agents/providers/hub-docker-com/container-images/get_repository): One public repository from Docker Hub's `/v2/repositories/{namespace}/{repository}/`: description and full Markdown description, pull and star counts, last push/update and registration timestamps, categories, manifest media types and content types, storage size, registry region and immutable-tag setting. Official images live in the `library` namespace (`library/nginx`). Accepts a pasted `https://hub.docker.com/_/{repo}` or `/r/{namespace}/{repo}` URL instead of the name pair. - [Get tag](https://firecrawl.dev/alexandria/agents/providers/hub-docker-com/container-images/get_tag): One tag of a repository from Docker Hub's `/v2/repositories/{namespace}/{repository}/tags/{tag}`: manifest digest, size, media and content type, status, last push/pull/update timestamps, last updater and the per-platform images (architecture, variant, OS, digest, size, status, last pushed/pulled). - [List categories](https://firecrawl.dev/alexandria/agents/providers/hub-docker-com/container-images/list_categories): The fixed list of Docker Hub catalog categories from `/v2/categories/` (name and slug, e.g. `Databases & storage` / `databases-and-storage`); slugs feed `search_images.categories`. - [List namespace repositories](https://firecrawl.dev/alexandria/agents/providers/hub-docker-com/container-images/list_namespace_repositories): Public repositories of one namespace (organization or user) from Docker Hub's `/v2/repositories/{namespace}/`: name, description, pull and star counts, last push and registration timestamps, categories, media and content types, storage size and registry region. `library` lists the Docker Official Images. Pages of `page_size` repositories; `cursor` is the next page number. An unknown namespace is `not_found`. - [List tags](https://firecrawl.dev/alexandria/agents/providers/hub-docker-com/container-images/list_tags): Tags of one repository from Docker Hub's `/v2/repositories/{namespace}/{repository}/tags`: each tag with its manifest digest, size, media type, status, last push/pull/update timestamps, the account that last pushed it and one entry per platform (architecture, variant, OS, digest, size, last pushed/pulled). Optional substring filter on the tag name and ordering by last update (newest first by default, `-last_updated` oldest first) or by name. Pages of `page_size` tags; `cursor` is the next page number. - [Search images](https://firecrawl.dev/alexandria/agents/providers/hub-docker-com/container-images/search_images): Search Docker Hub's public catalog (`/api/search/v4`): images, Docker Hardened Images and Desktop extensions matching a query, with badge (official, verified publisher, open source, hardened), architecture, operating system and category filters, sorted by relevance, pull count or update time. Each hit carries the exact and the rounded pull count, star count, supported architectures and operating systems, categories, publisher, created/updated timestamps and its public URL; image hits also carry `namespace`/`repository` for `get_repository` and `list_tags`. Offset pages of `page_size` hits; `cursor` is the offset of the next page. ## 1. Choose this provider when Docker Hub, the public container image registry: catalog search with badge, architecture, OS and category filters; repository metadata and README; tag listings and tag detail with per-architecture digests, sizes and push dates; a namespace's repositories and profile; catalog categories; Docker Scout vulnerability summaries by image digest. ## 2. Minimal request Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls. ```json { "provider": "hub-docker-com", "capability": "container-images/get_image_vulnerability_summary", "options": { "digests": [ "sha256:e688fed0b0c7513a63364959e7d389c37ac8ecac7a6c6a31455eca2f5a71ab8b" ], "repository": "nginx" } } ``` ## 3. Add provider options Use only the options needed for the task: - `digests` (string[], required): Image digests to summarize (platform image or index digests from `list_tags`/`get_tag`). Example: `["list_tags"]` - `repository` (string, required): Repository as Docker Hub names it: `nginx` for official images, `namespace/repo` otherwise. Pattern: ^[a-z0-9]+(?:[._-][a-z0-9]+)*(?:/[a-z0-9]+(?:[._-][a-z0-9]+)*)?$. Example: `` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "hub-docker-com", capability: "container-images/get_image_vulnerability_summary", options: { digests: [ "sha256:e688fed0b0c7513a63364959e7d389c37ac8ecac7a6c6a31455eca2f5a71ab8b", ], repository: "nginx", }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "hub-docker-com", "capability": "container-images/get_image_vulnerability_summary", "options": { "digests": [ "sha256:e688fed0b0c7513a63364959e7d389c37ac8ecac7a6c6a31455eca2f5a71ab8b" ], "repository": "nginx" } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "hub-docker-com", "capability": "container-images/get_image_vulnerability_summary", "options": { "digests": [ "sha256:e688fed0b0c7513a63364959e7d389c37ac8ecac7a6c6a31455eca2f5a71ab8b" ], "repository": "nginx" } } }' ``` ### CLI ```sh firecrawl scrape 'hub-docker-com/container-images/get_image_vulnerability_summary' \ --options '{"digests":["sha256:e688fed0b0c7513a63364959e7d389c37ac8ecac7a6c6a31455eca2f5a71ab8b"],"repository":"nginx"}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "hub-docker-com", "capability": "container-images/get_image_vulnerability_summary", "options": { "digests": [ "sha256:e688fed0b0c7513a63364959e7d389c37ac8ecac7a6c6a31455eca2f5a71ab8b" ], "repository": "nginx" } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "hub-docker-com", "capability": "container-images/get_image_vulnerability_summary", "options": { "digests": [ "sha256:e688fed0b0c7513a63364959e7d389c37ac8ecac7a6c6a31455eca2f5a71ab8b" ], "repository": "nginx" } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "missing_digests": [], "observed_at_ms": 1791237734403, "repository": "nginx", "requested": 1, "results": [ { "digest": "sha256:e688fed0b0c7513a63364959e7d389c37ac8ecac7a6c6a31455eca2f5a71ab8b", "sbom_state": "INDEXED", "vulnerabilities": { "critical": 15, "high": 111, "low": 117, "medium": 105, "total": 379, "unspecified": 31 } } ], "source_url": "https://api.scout.docker.com/v1/graphql" } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Get image vulnerability summary - Capability: `container-images/get_image_vulnerability_summary` - Description: Docker Scout's public vulnerability summary for image digests of a Docker Hub repository (`api.scout.docker.com/v1/graphql`, query `imageSummariesByDigest`): per digest the SBOM indexing state and the count of critical, high, medium, low and unspecified CVEs. Digests come from `list_tags`/`get_tag` (`images[].digest`). Digests Scout has not indexed are listed in `missing_digests`; when none of the requested digests is known the call is `not_found`. - Instructions: Check how many known vulnerabilities a specific image digest carries before pulling it; pair with `get_tag` to go from a tag name to its per-architecture digests. - Cost: 5 credits per call - Capability file: [Get image vulnerability summary](https://firecrawl.dev/alexandria/agents/providers/hub-docker-com/container-images/get_image_vulnerability_summary) Accepted options: - `digests` (string[], required): Image digests to summarize (platform image or index digests from `list_tags`/`get_tag`). Example: `["list_tags"]` - `repository` (string, required): Repository as Docker Hub names it: `nginx` for official images, `namespace/repo` otherwise. Pattern: ^[a-z0-9]+(?:[._-][a-z0-9]+)*(?:/[a-z0-9]+(?:[._-][a-z0-9]+)*)?$. Example: `` Response schema example: ```json { "missing_digests": [], "observed_at_ms": 1791237734403, "repository": "nginx", "requested": 1, "results": [ { "digest": "sha256:e688fed0b0c7513a63364959e7d389c37ac8ecac7a6c6a31455eca2f5a71ab8b", "sbom_state": "INDEXED", "vulnerabilities": { "critical": 15, "high": 111, "low": 117, "medium": 105, "total": 379, "unspecified": 31 } } ], "source_url": "https://api.scout.docker.com/v1/graphql" } ``` ### Get namespace - Capability: `container-images/get_namespace` - Description: Public profile of a Docker Hub namespace from `/v2/orgs/{namespace}/` (which also answers for individual users): type (Organization or User), display name, company, location, profile link, join date, avatar and, for organizations, the verified-publisher badge and active flag. - Instructions: Identify who publishes an image (organization vs. individual, company, website) from the namespace in a repository name. - Cost: 5 credits per call - Capability file: [Get namespace](https://firecrawl.dev/alexandria/agents/providers/hub-docker-com/container-images/get_namespace) Accepted options: - `namespace` (string, required): Docker Hub namespace: an organization or user name; `library` for Docker Official Images. Pattern: ^[a-z0-9]+(?:[._-][a-z0-9]+)*$. Example: `` Response schema example: ```json { "badge": "verified_publisher", "company": "Grafana Labs", "date_joined": "2014-06-14T05:02:48.831028Z", "full_name": "Grafana", "gravatar_url": "https://www.gravatar.com/avatar/31cea69afa424609b2d83621b4d47f1d?s=80&r=g&d=mm", "id": "75dd122074c011e4bea40242ac11001b", "is_active": true, "location": "Sweden", "namespace": "grafana", "observed_at_ms": 1791237700698, "profile_url": "https://grafana.com/", "source_url": "https://hub.docker.com/v2/orgs/grafana/", "type": "Organization", "url": "https://hub.docker.com/u/grafana", "uuid": "75dd1220-74c0-11e4-bea4-0242ac11001b" } ``` ### Get repository - Capability: `container-images/get_repository` - Description: One public repository from Docker Hub's `/v2/repositories/{namespace}/{repository}/`: description and full Markdown description, pull and star counts, last push/update and registration timestamps, categories, manifest media types and content types, storage size, registry region and immutable-tag setting. Official images live in the `library` namespace (`library/nginx`). Accepts a pasted `https://hub.docker.com/_/{repo}` or `/r/{namespace}/{repo}` URL instead of the name pair. - Instructions: Read one image's metadata and README after finding it with `search_images`, or when the user gives a Docker Hub repository name or URL. - Cost: 5 credits per call - Capability file: [Get repository](https://firecrawl.dev/alexandria/agents/providers/hub-docker-com/container-images/get_repository) Accepted options: - `namespace` (string): Docker Hub namespace: an organization or user name; `library` for Docker Official Images. Pattern: ^[a-z0-9]+(?:[._-][a-z0-9]+)*$. Example: `library` - `repository` (string): Repository name within the namespace (e.g. `nginx`, `grafana`). Pattern: ^[a-z0-9]+(?:[._-][a-z0-9]+)*$. Example: `` - `url` (string): A Docker Hub repository page URL (`https://hub.docker.com/_/nginx` or `https://hub.docker.com/r/grafana/grafana`); exclusive with `repository`. Example: `https://hub.docker.com/_/nginx` Response schema example: ```json { "categories": [ { "name": "Security", "slug": "security" }, { "name": "Internet of things", "slug": "internet-of-things" }, { "name": "Monitoring & observability", "slug": "monitoring-and-observability" } ], "collaborator_count": 0, "content_types": [ "image" ], "date_registered": "2015-02-06T09:29:43.405876Z", "description": "The official Grafana docker container", "full_description": "# Grafana Docker image\n\n## Run the Grafana Docker container\n\nStart the Docker container by binding Grafana to external port `3000`.\n\n```bash\ndocker run -d --name=grafana -p 3000:3000 grafana/grafana\n```\n\nTry it out, default admin user credentials are admin/admin.\n\nFurther documentation on how to run Docker can be found at http://docs.grafana.org/installation/docker/.\n\n## Changelog\n\nYou can find information about Grafana in our [docs](https://grafana.com/docs/), or find out what's new in the latest release [here](https://grafana.com/docs/grafana/latest/whatsnew/)!", "full_name": "grafana/grafana", "hub_user": "grafana", "immutable_tags_enabled": false, "is_automated": false, "is_private": false, "last_modified": "2024-10-16T13:48:34.145251Z", "last_updated": "2026-10-05T01:34:56.294231Z", "media_types": [ "application/vnd.docker.container.image.v1+json", "application/vnd.docker.distribution.manifest.list.v2+json", "application/vnd.docker.distribution.manifest.v1+prettyjws" ], "name": "grafana", "namespace": "grafana", "observed_at_ms": 1791237659708, "pull_count": 5346090424, "registry_region": { "label": "US", "name": "us-east-1" }, "repository_type": "image", "source_url": "https://hub.docker.com/v2/repositories/grafana/grafana/", "star_count": 3588, "status": 1, "status_description": "active", "storage_size": 31200074974286, "url": "https://hub.docker.com/r/grafana/grafana" } ``` ### Get tag - Capability: `container-images/get_tag` - Description: One tag of a repository from Docker Hub's `/v2/repositories/{namespace}/{repository}/tags/{tag}`: manifest digest, size, media and content type, status, last push/pull/update timestamps, last updater and the per-platform images (architecture, variant, OS, digest, size, status, last pushed/pulled). - Instructions: Resolve a tag such as `latest` to its digests and supported architectures, or check when a specific tag was last pushed. - Cost: 5 credits per call - Capability file: [Get tag](https://firecrawl.dev/alexandria/agents/providers/hub-docker-com/container-images/get_tag) Accepted options: - `namespace` (string): Docker Hub namespace: an organization or user name; `library` for Docker Official Images. Pattern: ^[a-z0-9]+(?:[._-][a-z0-9]+)*$. Example: `library` - `repository` (string, required): Repository name within the namespace (e.g. `nginx`, `grafana`). Pattern: ^[a-z0-9]+(?:[._-][a-z0-9]+)*$. Example: `` - `tag` (string, required): Tag name exactly as Docker Hub lists it (e.g. `latest`, `1.29.1-alpine`). Pattern: ^[A-Za-z0-9_][A-Za-z0-9_.-]*$. Example: `` Response schema example: ```json { "content_type": "image", "digest": "sha256:abe47724e466aeab9a345d8e46a221c2fa8953c7848bb4a3bd9976a7199f8cf2", "full_size": 63400795, "id": 19451, "images": [ { "architecture": "amd64", "digest": "sha256:9c0f39aa1c46f5062ba080555a067ebb82d5f63a8cf4d63f6ef2e76fc9ff2d0c", "last_pulled": "2026-10-05T21:59:57.829999985Z", "last_pushed": "2026-09-19T01:50:19.006282393Z", "os": "linux", "os_version": null, "size": 63400795, "status": "active", "variant": null }, { "architecture": "ppc64le", "digest": "sha256:1ad1d69bf75eef7e78cd31a3eebba1d376a3c51a5579635d995d8e1896426466", "last_pulled": "2026-10-05T22:00:17.171806931Z", "last_pushed": "2026-09-19T01:50:21.284393583Z", "os": "linux", "os_version": null, "size": 67620928, "status": "active", "variant": null }, { "architecture": "386", "digest": "sha256:7091b89b716bf1a189d0aa3a5c9d3cb8e2090c6a8290c5553663747582ccfefc", "last_pulled": "2026-10-05T21:51:38.072371176Z", "last_pushed": "2026-09-19T04:50:18.304734409Z", "os": "linux", "os_version": null, "size": 63846535, "status": "active", "variant": null }, { "architecture": "s390x", "digest": "sha256:b70a461b4fe976316a95568526673c074488b9d364235807f27f960a12baea1c", "last_pulled": "2026-10-05T21:53:38.936926131Z", "last_pushed": "2026-09-19T04:50:19.158451781Z", "os": "linux", "os_version": null, "size": 61061782, "status": "active", "variant": null }, { "architecture": "arm", "digest": "sha256:7c0a84ff6658d96f1740787f8590bce29570c0865aed96fc184486e84ac002dc", "last_pulled": "2026-10-05T22:00:14.340264784Z", "last_pushed": "2026-09-19T01:50:19.763880553Z", "os": "linux", "os_version": null, "size": 52757828, "status": "active", "variant": "v7" }, { "architecture": "arm64", "digest": "sha256:918e8d119b7c1ff9b0e5bcc65b054417c35cce2a34efdfbdb33030e6ea13bafe", "last_pulled": "2026-10-05T21:50:56.401446234Z", "last_pushed": "2026-09-19T01:50:20.522422994Z", "os": "linux", "os_version": null, "size": 61743858, "status": "active", "variant": "v8" }, { "architecture": "arm", "digest": "sha256:80e8942d76c2384853ff8250bc88ce7a28110e774b98592f161686fd80dc4353", "last_pulled": "2026-10-05T21:58:38.751435199Z", "last_pushed": "2026-09-19T04:50:17.512165126Z", "os": "linux", "os_version": null, "size": 54407274, "status": "active", "variant": "v5" }, { "architecture": "riscv64", "digest": "sha256:9f1d10e21b690941793f76cbc6df29a8974ac2815dcbbb6d850144fdd53369ae", "last_pulled": "2026-10-05T21:57:13.561128751Z", "last_pushed": "2026-09-03T13:50:12.222011688Z", "os": "linux", "os_version": null, "size": 60724615, "status": "active", "variant": null }, { "architecture": "unknown", "digest": "sha256:fdd27b1339a4f4120fd15268728385d78de03be06e7381c11f676d436f26fb7d", "last_pulled": "2026-10-05T21:56:07.83499796Z", "last_pushed": "2026-09-19T01:50:21.644807766Z", "os": "unknown", "os_version": null, "size": 2886521, "status": "active", "variant": null }, { "architecture": "unknown", "digest": "sha256:aebba161d93e7ba5e9b3d337b3e1d56cfc562b3c56321b2f1f6e6d886f2ae6bb", "last_pulled": "2026-10-05T21:56:35.994582618Z", "last_pushed": "2026-09-03T13:50:12.633529993Z", "os": "unknown", "os_version": null, "size": 2870598, "status": "active", "variant": null }, { "architecture": "unknown", "digest": "sha256:a3f4937fe245f336bca6e75583ad73224e13b4ecc603312de294a68066ea4c68", "last_pulled": "2026-10-05T21:57:06.862792523Z", "last_pushed": "2026-09-19T04:50:17.952751474Z", "os": "unknown", "os_version": null, "size": 2885179, "status": "active", "variant": null }, { "architecture": "unknown", "digest": "sha256:e57665aa5d617dabbcbd698d722d50f735dfabf98512b13b20bec4844eff78e4", "last_pulled": "2026-10-05T21:57:15.776493181Z", "last_pushed": "2026-09-19T04:50:19.548972423Z", "os": "unknown", "os_version": null, "size": 2792196, "status": "active", "variant": null }, { "architecture": "unknown", "digest": "sha256:86753677ff59291f6024a78342b5e651bfd2786b230f2c1bbe77ce47d6b7bfd9", "last_pulled": "2026-10-05T21:56:53.23191108Z", "last_pushed": "2026-09-19T01:50:20.127323709Z", "os": "unknown", "os_version": null, "size": 2883924, "status": "active", "variant": null }, { "architecture": "unknown", "digest": "sha256:9a536b164be3731414c1c9152b60dc139a6e1f350374d237d98da22133fa7e38", "last_pulled": "2026-10-05T21:57:34.713026372Z", "last_pushed": "2026-09-19T01:50:20.90350573Z", "os": "unknown", "os_version": null, "size": 2859541, "status": "active", "variant": null }, { "architecture": "unknown", "digest": "sha256:752ced86f64e822e3176a7ea48ef7107e3a0ba33b89f4363a2eb2995e9ebc060", "last_pulled": "2026-10-05T21:57:11.337097478Z", "last_pushed": "2026-09-19T04:50:18.709585803Z", "os": "unknown", "os_version": null, "size": 2878684, "status": "active", "variant": null }, { "architecture": "unknown", "digest": "sha256:11e4aa39f602bc95fa0e3b48a2ef47005d23f3424ca21d0d171691d55b0c076b", "last_pulled": "2026-10-05T21:51:52.978098266Z", "last_pushed": "2026-09-19T01:50:19.381083785Z", "os": "unknown", "os_version": null, "size": 2858889, "status": "active", "variant": null } ], "last_updated": "2026-09-19T04:53:15.496569Z", "last_updater_username": "doijanky", "media_type": "application/vnd.oci.image.index.v1+json", "name": "latest", "namespace": "library", "observed_at_ms": 1791237680489, "repository": "nginx", "source_url": "https://hub.docker.com/v2/repositories/library/nginx/tags/latest", "tag_last_pulled": "2026-10-05T22:00:17.171806931Z", "tag_last_pushed": "2026-09-19T04:53:15.496569Z", "tag_status": "active", "url": "https://hub.docker.com/_/nginx/tags?name=latest", "v2": true } ``` ### List categories - Capability: `container-images/list_categories` - Description: The fixed list of Docker Hub catalog categories from `/v2/categories/` (name and slug, e.g. `Databases & storage` / `databases-and-storage`); slugs feed `search_images.categories`. - Instructions: Look up the category slug to filter a search by, or show the available categories. - Cost: 5 credits per call - Capability file: [List categories](https://firecrawl.dev/alexandria/agents/providers/hub-docker-com/container-images/list_categories) Accepted options: Response schema example: ```json { "categories": [ { "name": "Networking", "slug": "networking" }, { "name": "Security", "slug": "security" }, { "name": "Languages & frameworks", "slug": "languages-and-frameworks" }, { "name": "Integration & delivery", "slug": "integration-and-delivery" }, { "name": "Message queues", "slug": "message-queues" }, { "name": "API management", "slug": "api-management" }, { "name": "Internet of things", "slug": "internet-of-things" }, { "name": "Machine learning & AI", "slug": "machine-learning-and-ai" }, { "name": "Developer tools", "slug": "developer-tools" }, { "name": "Data science", "slug": "data-science" }, { "name": "Web servers", "slug": "web-servers" }, { "name": "Operating systems", "slug": "operating-systems" }, { "name": "Content management system", "slug": "content-management-system" }, { "name": "Databases & storage", "slug": "databases-and-storage" }, { "name": "Monitoring & observability", "slug": "monitoring-and-observability" }, { "name": "Web analytics", "slug": "web-analytics" } ], "count": 16, "observed_at_ms": 1791237710802, "source_url": "https://hub.docker.com/v2/categories/" } ``` ### List namespace repositories - Capability: `container-images/list_namespace_repositories` - Description: Public repositories of one namespace (organization or user) from Docker Hub's `/v2/repositories/{namespace}/`: name, description, pull and star counts, last push and registration timestamps, categories, media and content types, storage size and registry region. `library` lists the Docker Official Images. Pages of `page_size` repositories; `cursor` is the next page number. An unknown namespace is `not_found`. - Instructions: Enumerate everything a publisher ships (e.g. all `grafana/*` images or all official images) before reading individual repositories. - Cost: 5 credits per call - Capability file: [List namespace repositories](https://firecrawl.dev/alexandria/agents/providers/hub-docker-com/container-images/list_namespace_repositories) Accepted options: - `cursor` (string): `next_cursor` from a previous page (the 1-based page number). Pattern: ^[0-9]+$. Example: `next_cursor` - `namespace` (string, required): Docker Hub namespace: an organization or user name; `library` for Docker Official Images. Pattern: ^[a-z0-9]+(?:[._-][a-z0-9]+)*$. Example: `` - `ordering` (string): `last_updated`: most recently pushed first. Omit for Docker Hub's default order. Example: `last_updated` - `page_size` (number): Records per page (Docker Hub clamps anything above 100 to 100). Example: `25` Response schema example: ```json { "count": 10, "namespace": "grafana", "next_cursor": "2", "observed_at_ms": 1791237691134, "page": 1, "page_size": 10, "repositories": [ { "categories": [ { "name": "Internet of things", "slug": "internet-of-things" }, { "name": "Monitoring & observability", "slug": "monitoring-and-observability" }, { "name": "Security", "slug": "security" } ], "content_types": [ "image" ], "date_registered": "2015-02-06T09:29:43.405876Z", "description": "The official Grafana docker container", "full_name": "grafana/grafana", "is_private": false, "last_modified": "2024-10-16T13:48:34.145251Z", "last_updated": "2026-10-05T01:34:56.294231Z", "media_types": [ "application/vnd.docker.container.image.v1+json", "application/vnd.docker.distribution.manifest.list.v2+json", "application/vnd.docker.distribution.manifest.v1+prettyjws" ], "name": "grafana", "namespace": "grafana", "pull_count": 5346091078, "registry_region": { "label": "US", "name": "us-east-1" }, "repository_type": "image", "star_count": 3588, "status_description": "active", "storage_size": 31200074974286, "url": "https://hub.docker.com/r/grafana/grafana" }, { "categories": [], "content_types": [ "image" ], "date_registered": "2016-05-13T13:38:07.975179Z", "description": null, "full_name": "grafana/fake-data-gen", "is_private": false, "last_modified": "2024-10-16T13:48:34.145251Z", "last_updated": "2026-04-21T13:22:16.422791Z", "media_types": [ "application/vnd.docker.container.image.v1+json", "application/vnd.oci.image.index.v1+json" ], "name": "fake-data-gen", "namespace": "grafana", "pull_count": 28687, "registry_region": { "label": "US", "name": "us-east-1" }, "repository_type": "image", "star_count": 0, "status_description": "active", "storage_size": 2340159021, "url": "https://hub.docker.com/r/grafana/fake-data-gen" }, { "categories": [], "content_types": [ "image" ], "date_registered": "2017-09-30T01:04:30.750252Z", "description": null, "full_name": "grafana/metrictank", "is_private": false, "last_modified": "2024-10-16T13:48:34.145251Z", "last_updated": "2022-12-28T13:46:32.901087Z", "media_types": [ "application/vnd.docker.container.image.v1+json", "application/vnd.docker.distribution.manifest.v1+prettyjws" ], "name": "metrictank", "namespace": "grafana", "pull_count": 215199, "registry_region": { "label": "US", "name": "us-east-1" }, "repository_type": "image", "star_count": 0, "status_description": "active", "storage_size": 80419831891, "url": "https://hub.docker.com/r/grafana/metrictank" }, { "categories": [], "content_types": [ "image" ], "date_registered": "2017-11-23T08:44:03.42618Z", "description": null, "full_name": "grafana/worldping-gw", "is_private": false, "last_modified": "2024-10-16T13:48:34.145251Z", "last_updated": "2020-09-03T15:36:37.075735Z", "media_types": [ "application/vnd.docker.container.image.v1+json" ], "name": "worldping-gw", "namespace": "grafana", "pull_count": 65481, "registry_region": { "label": "US", "name": "us-east-1" }, "repository_type": "image", "star_count": 0, "status_description": "active", "storage_size": 134099088, "url": "https://hub.docker.com/r/grafana/worldping-gw" }, { "categories": [ { "name": "Languages & frameworks", "slug": "languages-and-frameworks" }, { "name": "Integration & delivery", "slug": "integration-and-delivery" }, { "name": "Monitoring & observability", "slug": "monitoring-and-observability" } ], "content_types": [ "image" ], "date_registered": "2018-02-21T12:47:27.989303Z", "description": "Container used for building grafana. ", "full_name": "grafana/build-container", "is_private": false, "last_modified": "2024-10-16T13:48:34.145251Z", "last_updated": "2023-09-18T09:25:44.819147Z", "media_types": [ "application/vnd.docker.container.image.v1+json", "application/vnd.oci.image.config.v1+json" ], "name": "build-container", "namespace": "grafana", "pull_count": 574059, "registry_region": { "label": "US", "name": "us-east-1" }, "repository_type": "image", "star_count": 0, "status_description": "active", "storage_size": 177878869576, "url": "https://hub.docker.com/r/grafana/build-container" }, { "categories": [], "content_types": [ "image" ], "date_registered": "2018-03-26T19:11:40.888824Z", "description": null, "full_name": "grafana/cortex-alertmanager", "is_private": false, "last_modified": "2024-10-16T13:48:34.145251Z", "last_updated": "2019-07-11T21:55:34.496369Z", "media_types": [ "application/vnd.docker.container.image.v1+json", "application/vnd.docker.distribution.manifest.v1+prettyjws" ], "name": "cortex-alertmanager", "namespace": "grafana", "pull_count": 27566, "registry_region": { "label": "US", "name": "us-east-1" }, "repository_type": "image", "star_count": 0, "status_description": "active", "storage_size": 795065178, "url": "https://hub.docker.com/r/grafana/cortex-alertmanager" }, { "categories": [], "content_types": [ "image" ], "date_registered": "2018-03-26T19:12:04.119613Z", "description": null, "full_name": "grafana/cortex-ingester", "is_private": false, "last_modified": "2024-10-16T13:48:34.145251Z", "last_updated": "2019-07-11T21:54:38.801996Z", "media_types": [ "application/vnd.docker.container.image.v1+json", "application/vnd.docker.distribution.manifest.v1+prettyjws" ], "name": "cortex-ingester", "namespace": "grafana", "pull_count": 28419, "registry_region": { "label": "US", "name": "us-east-1" }, "repository_type": "image", "star_count": 0, "status_description": "active", "storage_size": 1026223334, "url": "https://hub.docker.com/r/grafana/cortex-ingester" }, { "categories": [], "content_types": [ "image" ], "date_registered": "2018-03-26T19:12:19.882347Z", "description": null, "full_name": "grafana/cortex-lite", "is_private": false, "last_modified": "2024-10-16T13:48:34.145251Z", "last_updated": "2019-07-11T21:55:22.88308Z", "media_types": [ "application/vnd.docker.container.image.v1+json", "application/vnd.docker.distribution.manifest.v1+prettyjws" ], "name": "cortex-lite", "namespace": "grafana", "pull_count": 27059, "registry_region": { "label": "US", "name": "us-east-1" }, "repository_type": "image", "star_count": 0, "status_description": "active", "storage_size": 1909888693, "url": "https://hub.docker.com/r/grafana/cortex-lite" }, { "categories": [], "content_types": [ "image" ], "date_registered": "2018-03-26T19:12:34.301562Z", "description": null, "full_name": "grafana/cortex-querier", "is_private": false, "last_modified": "2024-10-16T13:48:34.145251Z", "last_updated": "2019-07-11T21:54:51.561617Z", "media_types": [ "application/vnd.docker.container.image.v1+json", "application/vnd.docker.distribution.manifest.v1+prettyjws" ], "name": "cortex-querier", "namespace": "grafana", "pull_count": 39568, "registry_region": { "label": "US", "name": "us-east-1" }, "repository_type": "image", "star_count": 0, "status_description": "active", "storage_size": 2680540862, "url": "https://hub.docker.com/r/grafana/cortex-querier" }, { "categories": [], "content_types": [ "image" ], "date_registered": "2018-03-26T19:12:52.124156Z", "description": null, "full_name": "grafana/cortex-distributor", "is_private": false, "last_modified": "2024-10-16T13:48:34.145251Z", "last_updated": "2019-07-11T21:55:09.020712Z", "media_types": [ "application/vnd.docker.container.image.v1+json", "application/vnd.docker.distribution.manifest.v1+prettyjws" ], "name": "cortex-distributor", "namespace": "grafana", "pull_count": 28734, "registry_region": { "label": "US", "name": "us-east-1" }, "repository_type": "image", "star_count": 0, "status_description": "active", "storage_size": 759756732, "url": "https://hub.docker.com/r/grafana/cortex-distributor" } ], "source_url": "https://hub.docker.com/v2/repositories/grafana/?page_size=10&page=1", "total": 194 } ``` ### List tags - Capability: `container-images/list_tags` - Description: Tags of one repository from Docker Hub's `/v2/repositories/{namespace}/{repository}/tags`: each tag with its manifest digest, size, media type, status, last push/pull/update timestamps, the account that last pushed it and one entry per platform (architecture, variant, OS, digest, size, last pushed/pulled). Optional substring filter on the tag name and ordering by last update (newest first by default, `-last_updated` oldest first) or by name. Pages of `page_size` tags; `cursor` is the next page number. - Instructions: List or filter the tags of an image, see which architectures each tag supports and when it was last pushed, and pick a tag or digest for `get_tag` or `get_image_vulnerability_summary`. - Cost: 5 credits per call - Capability file: [List tags](https://firecrawl.dev/alexandria/agents/providers/hub-docker-com/container-images/list_tags) Accepted options: - `cursor` (string): `next_cursor` from a previous page (the 1-based page number). Pattern: ^[0-9]+$. Example: `next_cursor` - `name` (string): Substring filter on the tag name (e.g. `alpine`). Pattern: ^[A-Za-z0-9_.-]+$. Example: `` - `namespace` (string): Docker Hub namespace: an organization or user name; `library` for Docker Official Images. Pattern: ^[a-z0-9]+(?:[._-][a-z0-9]+)*$. Example: `library` - `ordering` (string): `last_updated` (newest first, Docker Hub's default), `-last_updated` (oldest first) or `name`. Example: `last_updated` - `page_size` (number): Records per page (Docker Hub clamps anything above 100 to 100). Example: `25` - `repository` (string, required): Repository name within the namespace (e.g. `nginx`, `grafana`). Pattern: ^[a-z0-9]+(?:[._-][a-z0-9]+)*$. Example: `` Response schema example: ```json { "count": 2, "namespace": "library", "next_cursor": "2", "observed_at_ms": 1791237670032, "page": 1, "page_size": 2, "repository": "nginx", "source_url": "https://hub.docker.com/v2/repositories/library/nginx/tags?page_size=2&page=1", "tags": [ { "content_type": "image", "digest": "sha256:756444d493424be61c13714ec55c97a733942d67772fca9d1724fb264f8bde08", "full_size": 36364210, "id": 1235098847, "images": [ { "architecture": "amd64", "digest": "sha256:604b4e5233f9c948f4d26392354d76c582a4ce19833816374c1307b7fb59b53b", "last_pulled": "2026-10-05T21:54:03.368860437Z", "last_pushed": "2026-09-23T01:51:52.369719177Z", "os": "linux", "os_version": null, "size": 36364210, "status": "active", "variant": null }, { "architecture": "ppc64le", "digest": "sha256:6a4d97207a11667f6302686ff3affd40a5f08b63d0b1736ab73fb62a6cb6a3a2", "last_pulled": "2026-10-05T21:47:19.687669919Z", "last_pushed": "2026-09-23T01:51:56.155157038Z", "os": "linux", "os_version": null, "size": 36840545, "status": "active", "variant": null }, { "architecture": "386", "digest": "sha256:78f524e6c36a17cc2dc85f24de2e576407121653ffda6ab9c5ea3bbdefe94b3d", "last_pulled": "2026-10-05T21:47:19.622701546Z", "last_pushed": "2026-09-23T01:51:55.38710444Z", "os": "linux", "os_version": null, "size": 35151073, "status": "active", "variant": null }, { "architecture": "s390x", "digest": "sha256:d6da1eb17f17b33117d486d3a02af07d71e67fe2c4ef54008ad379e6dc690f09", "last_pulled": "2026-10-05T21:47:19.802088657Z", "last_pushed": "2026-09-23T01:51:56.9284205Z", "os": "linux", "os_version": null, "size": 36900568, "status": "active", "variant": null }, { "architecture": "arm", "digest": "sha256:379fd74f519a1a463950c1dd82c568d2d28a7ea61642bcd023a60fe3783b0db9", "last_pulled": "2026-10-05T21:47:19.53712956Z", "last_pushed": "2026-09-23T01:51:53.906985271Z", "os": "linux", "os_version": null, "size": 31042084, "status": "active", "variant": "v7" }, { "architecture": "arm64", "digest": "sha256:7429ae2e9f8d443721ad5127c8f6e66db3c7b97a82f5cf1eb9dd4d9faa02151e", "last_pulled": "2026-10-05T21:47:19.56495616Z", "last_pushed": "2026-09-23T01:51:54.646666678Z", "os": "linux", "os_version": null, "size": 36203082, "status": "active", "variant": "v8" }, { "architecture": "arm", "digest": "sha256:4bbb43aed3aca5eb9886353f92f3f0773a409c05838c8eacad31066c42b901f9", "last_pulled": "2026-10-05T21:47:19.447236408Z", "last_pushed": "2026-09-23T01:51:53.186659725Z", "os": "linux", "os_version": null, "size": 29208698, "status": "active", "variant": "v6" }, { "architecture": "riscv64", "digest": "sha256:67ae93fbc84698c5c9288cf13703192f7189e43bf921bcb35726091bb3f72fb1", "last_pulled": "2026-10-05T21:47:19.758813215Z", "last_pushed": "2026-09-29T19:50:36.679081214Z", "os": "linux", "os_version": null, "size": 33238185, "status": "active", "variant": null }, { "architecture": "unknown", "digest": "sha256:f98b7d97073181ad512cee778989040813c47f1076c94bcefa593f664a22e5ab", "last_pulled": "2026-10-05T21:47:19.704746821Z", "last_pushed": "2026-09-23T01:51:56.571643313Z", "os": "unknown", "os_version": null, "size": 1853891, "status": "active", "variant": null }, { "architecture": "unknown", "digest": "sha256:415a854f1e3a1bfc20e93134dd3269bce71fea6e103f12064f609e34790d9e0e", "last_pulled": "2026-10-05T21:47:19.78252249Z", "last_pushed": "2026-09-29T19:50:37.09879982Z", "os": "unknown", "os_version": null, "size": 1853886, "status": "active", "variant": null }, { "architecture": "unknown", "digest": "sha256:10a734bb9b9e62746e19330e97bc816fb8633c7c9b84321fc267a3f3a904d2f0", "last_pulled": "2026-10-05T21:47:19.881955108Z", "last_pushed": "2026-09-23T01:51:57.339188404Z", "os": "unknown", "os_version": null, "size": 1853785, "status": "active", "variant": null }, { "architecture": "unknown", "digest": "sha256:0a9de7aa4444fd08519cb6a8ee37eb3beededf3296383c820ca608207d4e89a8", "last_pulled": "2026-10-05T21:55:42.074806679Z", "last_pushed": "2026-09-23T01:51:52.839112928Z", "os": "unknown", "os_version": null, "size": 1854438, "status": "active", "variant": null }, { "architecture": "unknown", "digest": "sha256:b762783efd2e85cf24c4706075abcecbb5b50cc5c8d581677a6200c868249209", "last_pulled": "2026-10-05T21:47:19.444608265Z", "last_pushed": "2026-09-23T01:51:53.598330809Z", "os": "unknown", "os_version": null, "size": 20126, "status": "active", "variant": null }, { "architecture": "unknown", "digest": "sha256:dc7c7670401df95c06fd5d363ea412f54623eb2b2232c56a50f5ef175936e3bf", "last_pulled": "2026-10-05T21:47:19.554630182Z", "last_pushed": "2026-09-23T01:51:54.31165265Z", "os": "unknown", "os_version": null, "size": 1853947, "status": "active", "variant": null }, { "architecture": "unknown", "digest": "sha256:3dcf53d1bae28b877600ec40568a28f540a39df49abb919bd240af66f60f92df", "last_pulled": "2026-10-05T21:47:19.591284281Z", "last_pushed": "2026-09-23T01:51:55.070054291Z", "os": "unknown", "os_version": null, "size": 1853998, "status": "active", "variant": null }, { "architecture": "unknown", "digest": "sha256:6a89ff86f9da429b08042ad7fbe746ae90fff5586b54e4c9d18f80b81b319f45", "last_pulled": "2026-10-05T21:47:19.686127433Z", "last_pushed": "2026-09-23T01:51:55.831024929Z", "os": "unknown", "os_version": null, "size": 1854368, "status": "active", "variant": null } ], "last_updated": "2026-09-29T19:52:23.733189Z", "last_updater_username": "doijanky", "media_type": "application/vnd.oci.image.index.v1+json", "name": "stable-alpine3.24-perl", "tag_last_pulled": "2026-10-05T21:55:42.074806679Z", "tag_last_pushed": "2026-09-29T19:52:23.733189Z", "tag_status": "active", "v2": true }, { "content_type": "image", "digest": "sha256:756444d493424be61c13714ec55c97a733942d67772fca9d1724fb264f8bde08", "full_size": 36364210, "id": 10128355, "images": [ { "architecture": "amd64", "digest": "sha256:604b4e5233f9c948f4d26392354d76c582a4ce19833816374c1307b7fb59b53b", "last_pulled": "2026-10-05T21:54:03.368860437Z", "last_pushed": "2026-09-23T01:51:52.369719177Z", "os": "linux", "os_version": null, "size": 36364210, "status": "active", "variant": null }, { "architecture": "ppc64le", "digest": "sha256:6a4d97207a11667f6302686ff3affd40a5f08b63d0b1736ab73fb62a6cb6a3a2", "last_pulled": "2026-10-05T21:47:19.687669919Z", "last_pushed": "2026-09-23T01:51:56.155157038Z", "os": "linux", "os_version": null, "size": 36840545, "status": "active", "variant": null }, { "architecture": "386", "digest": "sha256:78f524e6c36a17cc2dc85f24de2e576407121653ffda6ab9c5ea3bbdefe94b3d", "last_pulled": "2026-10-05T21:47:19.622701546Z", "last_pushed": "2026-09-23T01:51:55.38710444Z", "os": "linux", "os_version": null, "size": 35151073, "status": "active", "variant": null }, { "architecture": "s390x", "digest": "sha256:d6da1eb17f17b33117d486d3a02af07d71e67fe2c4ef54008ad379e6dc690f09", "last_pulled": "2026-10-05T21:47:19.802088657Z", "last_pushed": "2026-09-23T01:51:56.9284205Z", "os": "linux", "os_version": null, "size": 36900568, "status": "active", "variant": null }, { "architecture": "arm", "digest": "sha256:379fd74f519a1a463950c1dd82c568d2d28a7ea61642bcd023a60fe3783b0db9", "last_pulled": "2026-10-05T21:47:19.53712956Z", "last_pushed": "2026-09-23T01:51:53.906985271Z", "os": "linux", "os_version": null, "size": 31042084, "status": "active", "variant": "v7" }, { "architecture": "arm64", "digest": "sha256:7429ae2e9f8d443721ad5127c8f6e66db3c7b97a82f5cf1eb9dd4d9faa02151e", "last_pulled": "2026-10-05T21:47:19.56495616Z", "last_pushed": "2026-09-23T01:51:54.646666678Z", "os": "linux", "os_version": null, "size": 36203082, "status": "active", "variant": "v8" }, { "architecture": "arm", "digest": "sha256:4bbb43aed3aca5eb9886353f92f3f0773a409c05838c8eacad31066c42b901f9", "last_pulled": "2026-10-05T21:47:19.447236408Z", "last_pushed": "2026-09-23T01:51:53.186659725Z", "os": "linux", "os_version": null, "size": 29208698, "status": "active", "variant": "v6" }, { "architecture": "riscv64", "digest": "sha256:67ae93fbc84698c5c9288cf13703192f7189e43bf921bcb35726091bb3f72fb1", "last_pulled": "2026-10-05T21:47:19.758813215Z", "last_pushed": "2026-09-29T19:50:36.679081214Z", "os": "linux", "os_version": null, "size": 33238185, "status": "active", "variant": null }, { "architecture": "unknown", "digest": "sha256:0a9de7aa4444fd08519cb6a8ee37eb3beededf3296383c820ca608207d4e89a8", "last_pulled": "2026-10-05T21:55:42.074806679Z", "last_pushed": "2026-09-23T01:51:52.839112928Z", "os": "unknown", "os_version": null, "size": 1854438, "status": "active", "variant": null }, { "architecture": "unknown", "digest": "sha256:b762783efd2e85cf24c4706075abcecbb5b50cc5c8d581677a6200c868249209", "last_pulled": "2026-10-05T21:47:19.444608265Z", "last_pushed": "2026-09-23T01:51:53.598330809Z", "os": "unknown", "os_version": null, "size": 20126, "status": "active", "variant": null }, { "architecture": "unknown", "digest": "sha256:dc7c7670401df95c06fd5d363ea412f54623eb2b2232c56a50f5ef175936e3bf", "last_pulled": "2026-10-05T21:47:19.554630182Z", "last_pushed": "2026-09-23T01:51:54.31165265Z", "os": "unknown", "os_version": null, "size": 1853947, "status": "active", "variant": null }, { "architecture": "unknown", "digest": "sha256:3dcf53d1bae28b877600ec40568a28f540a39df49abb919bd240af66f60f92df", "last_pulled": "2026-10-05T21:47:19.591284281Z", "last_pushed": "2026-09-23T01:51:55.070054291Z", "os": "unknown", "os_version": null, "size": 1853998, "status": "active", "variant": null }, { "architecture": "unknown", "digest": "sha256:6a89ff86f9da429b08042ad7fbe746ae90fff5586b54e4c9d18f80b81b319f45", "last_pulled": "2026-10-05T21:47:19.686127433Z", "last_pushed": "2026-09-23T01:51:55.831024929Z", "os": "unknown", "os_version": null, "size": 1854368, "status": "active", "variant": null }, { "architecture": "unknown", "digest": "sha256:f98b7d97073181ad512cee778989040813c47f1076c94bcefa593f664a22e5ab", "last_pulled": "2026-10-05T21:47:19.704746821Z", "last_pushed": "2026-09-23T01:51:56.571643313Z", "os": "unknown", "os_version": null, "size": 1853891, "status": "active", "variant": null }, { "architecture": "unknown", "digest": "sha256:415a854f1e3a1bfc20e93134dd3269bce71fea6e103f12064f609e34790d9e0e", "last_pulled": "2026-10-05T21:47:19.78252249Z", "last_pushed": "2026-09-29T19:50:37.09879982Z", "os": "unknown", "os_version": null, "size": 1853886, "status": "active", "variant": null }, { "architecture": "unknown", "digest": "sha256:10a734bb9b9e62746e19330e97bc816fb8633c7c9b84321fc267a3f3a904d2f0", "last_pulled": "2026-10-05T21:47:19.881955108Z", "last_pushed": "2026-09-23T01:51:57.339188404Z", "os": "unknown", "os_version": null, "size": 1853785, "status": "active", "variant": null } ], "last_updated": "2026-09-29T19:52:18.067316Z", "last_updater_username": "doijanky", "media_type": "application/vnd.oci.image.index.v1+json", "name": "stable-alpine-perl", "tag_last_pulled": "2026-10-05T21:55:42.074806679Z", "tag_last_pushed": "2026-09-29T19:52:18.067316Z", "tag_status": "active", "v2": true } ], "total": 1339 } ``` ### Search images - Capability: `container-images/search_images` - Description: Search Docker Hub's public catalog (`/api/search/v4`): images, Docker Hardened Images and Desktop extensions matching a query, with badge (official, verified publisher, open source, hardened), architecture, operating system and category filters, sorted by relevance, pull count or update time. Each hit carries the exact and the rounded pull count, star count, supported architectures and operating systems, categories, publisher, created/updated timestamps and its public URL; image hits also carry `namespace`/`repository` for `get_repository` and `list_tags`. Offset pages of `page_size` hits; `cursor` is the offset of the next page. - Instructions: Find container images by name or words before reading a repository or its tags; filter to official images, a CPU architecture or a category. - Cost: 5 credits per call - Capability file: [Search images](https://firecrawl.dev/alexandria/agents/providers/hub-docker-com/container-images/search_images) Accepted options: - `architectures` (string[]): CPU architecture filter: `amd64`, `arm64`, `arm`, `386`, `ppc64le`, `s390x`, `riscv64`, `mips64le`. Example: `["amd64"]` - `badges` (string[]): Badge filter; several values are OR-ed. Example: `[]` - `categories` (string[]): Category slugs from `list_categories` (e.g. `databases-and-storage`). Example: `["list_categories"]` - `cursor` (string): `next_cursor` from a previous page (the `from` offset). Pattern: ^[0-9]+$. Example: `next_cursor` - `operating_systems` (string[]): Operating system filter. Example: `[]` - `order` (string): Sort direction (used with `sort`); Docker Hub defaults to `desc`. Example: `asc` - `page_size` (number): Hits per page. Example: `25` - `query` (string): Search text. May be empty when at least one filter is given. Example: `` - `sort` (string): Sort key; omit for Docker Hub's relevance order. Example: `pull_count` - `type` (string): Catalog type filter as the Hub UI sends it: `image`, `extension`, `plugin`, `dhi`, `model`, `sbx_kit`, `compose`, `helm`. Observed with results: `image`, `extension`, `dhi`. Example: `image` Response schema example: ```json { "count": 10, "from": 0, "next_cursor": "10", "observed_at_ms": 1791237645157, "page_size": 10, "query": "nginx", "results": [ { "additional_metadata": { "els_available": true, "fips_compliant": true, "has_security_attestations": false, "stig_certified": true, "tools": [], "url": "https://nginx.org/" }, "architectures": [ { "label": "x86-64", "name": "amd64" }, { "label": "ARM 64", "name": "arm64" } ], "archived": false, "badge": "hardened", "categories": [ { "name": "Web servers", "slug": "Web servers" } ], "content_types": [ "image" ], "created_at": "2025-03-13T08:09:23.111065Z", "extension_reviewed": false, "id": "dhi/nginx", "logo_url": "https://djeqr6to3dedg.cloudfront.net/repo-logos/dhi/nginx/live/logo-1791224019121", "media_types": [ "application/vnd.oci.image.index.v1+json" ], "name": "Nginx", "namespace": null, "operating_systems": [ { "label": "Linux", "name": "linux" } ], "publisher": { "id": "b3ca4e261ea244c3a662a24602a90a2a", "name": "dhi" }, "pull_count": 6186234, "pull_count_display": "5M+", "repository": null, "short_description": "nginx (\"engine x\") is an HTTP web server, reverse proxy, content cache, load balancer, TCP/UDP proxy server, and mail proxy server.", "slug": "dhi/nginx", "star_count": 0, "type": "dhi", "updated_at": "2026-10-05T12:14:51.175430768Z", "url": "https://hub.docker.com/hardened-images/catalog/dhi/nginx" }, { "additional_metadata": { "has_security_attestations": false }, "architectures": [ { "label": "x86-64", "name": "amd64" }, { "label": "ARM 64", "name": "arm64" }, { "label": "arm", "name": "arm" }, { "label": "mips64le", "name": "mips64le" }, { "label": "ppc64le", "name": "ppc64le" }, { "label": "riscv64", "name": "riscv64" }, { "label": "IBM Z", "name": "s390x" }, { "label": "unknown", "name": "unknown" }, { "label": "386", "name": "386" } ], "archived": false, "badge": "official", "categories": [ { "name": "Web servers", "slug": "web-servers" } ], "content_types": [ "unrecognized", "image" ], "created_at": "2014-06-05T19:14:45Z", "extension_reviewed": false, "id": "library/nginx", "logo_url": "https://djeqr6to3dedg.cloudfront.net/repo-logos/library/nginx/live/logo-1790032455953.png", "media_types": [ "application/octet-stream", "application/vnd.docker.container.image.v1+json", "application/vnd.docker.distribution.manifest.list.v2+json", "application/vnd.docker.distribution.manifest.v1+prettyjws", "application/vnd.oci.image.index.v1+json" ], "name": "nginx", "namespace": "library", "operating_systems": [ { "label": "Linux", "name": "linux" }, { "label": "unknown", "name": "unknown" } ], "publisher": { "id": "33ef574274c011e4bea40242ac11001b", "name": "library" }, "pull_count": 13428544523, "pull_count_display": "1B+", "repository": "nginx", "short_description": "Official build of Nginx.", "slug": "nginx", "star_count": 21405, "type": "image", "updated_at": "2026-09-29T19:52:26.103017Z", "url": "https://hub.docker.com/_/nginx" }, { "additional_metadata": { "has_security_attestations": true }, "architectures": [ { "label": "ARM 64", "name": "arm64" }, { "label": "ppc64le", "name": "ppc64le" }, { "label": "IBM Z", "name": "s390x" }, { "label": "unknown", "name": "unknown" }, { "label": "x86-64", "name": "amd64" }, { "label": "arm", "name": "arm" } ], "archived": false, "badge": "verified_publisher", "categories": [], "content_types": [ "image" ], "created_at": "2018-04-13T14:35:20.051378Z", "extension_reviewed": false, "id": "nginx/nginx-ingress", "logo_url": "https://www.gravatar.com/avatar/6a6c67f4815a0379d3b697174b4f6805?s=80&r=g&d=mm", "media_types": [ "application/vnd.docker.container.image.v1+json", "application/vnd.docker.distribution.manifest.list.v2+json", "application/vnd.oci.image.index.v1+json" ], "name": "nginx/nginx-ingress", "namespace": "nginx", "operating_systems": [ { "label": "Linux", "name": "linux" }, { "label": "unknown", "name": "unknown" } ], "publisher": { "id": "4fc42e3e74c011e4bea40242ac11001b", "name": "NGINX Inc." }, "pull_count": 1087715030, "pull_count_display": "1B+", "repository": "nginx-ingress", "short_description": "NGINX and NGINX Plus Ingress Controllers for Kubernetes", "slug": "nginx/nginx-ingress", "star_count": 123, "type": "image", "updated_at": "2026-10-05T15:56:09.003295Z", "url": "https://hub.docker.com/r/nginx/nginx-ingress" }, { "additional_metadata": { "has_security_attestations": true }, "architectures": [ { "label": "x86-64", "name": "amd64" }, { "label": "arm", "name": "arm" }, { "label": "mips64le", "name": "mips64le" }, { "label": "ppc64le", "name": "ppc64le" }, { "label": "riscv64", "name": "riscv64" }, { "label": "unknown", "name": "unknown" }, { "label": "386", "name": "386" }, { "label": "ARM 64", "name": "arm64" }, { "label": "IBM Z", "name": "s390x" } ], "archived": false, "badge": "verified_publisher", "categories": [ { "name": "Integration & delivery", "slug": "integration-and-delivery" }, { "name": "Monitoring & observability", "slug": "monitoring-and-observability" }, { "name": "Web servers", "slug": "web-servers" } ], "content_types": [ "image" ], "created_at": "2018-05-29T14:01:56.936677Z", "extension_reviewed": false, "id": "nginx/nginx-prometheus-exporter", "logo_url": "https://www.gravatar.com/avatar/6a6c67f4815a0379d3b697174b4f6805?s=80&r=g&d=mm", "media_types": [ "application/vnd.docker.container.image.v1+json", "application/vnd.docker.distribution.manifest.list.v2+json", "application/vnd.oci.image.index.v1+json" ], "name": "nginx/nginx-prometheus-exporter", "namespace": "nginx", "operating_systems": [ { "label": "Linux", "name": "linux" }, { "label": "unknown", "name": "unknown" } ], "publisher": { "id": "4fc42e3e74c011e4bea40242ac11001b", "name": "NGINX Inc." }, "pull_count": 91349629, "pull_count_display": "50M+", "repository": "nginx-prometheus-exporter", "short_description": "NGINX Prometheus Exporter for NGINX and NGINX Plus", "slug": "nginx/nginx-prometheus-exporter", "star_count": 52, "type": "image", "updated_at": "2026-10-02T10:03:53.427437Z", "url": "https://hub.docker.com/r/nginx/nginx-prometheus-exporter" }, { "additional_metadata": { "has_security_attestations": true }, "architectures": [ { "label": "x86-64", "name": "amd64" }, { "label": "ARM 64", "name": "arm64" }, { "label": "ppc64le", "name": "ppc64le" }, { "label": "IBM Z", "name": "s390x" }, { "label": "unknown", "name": "unknown" } ], "archived": false, "badge": "verified_publisher", "categories": [ { "name": "Integration & delivery", "slug": "integration-and-delivery" }, { "name": "Monitoring & observability", "slug": "monitoring-and-observability" }, { "name": "Networking", "slug": "networking" } ], "content_types": [ "image" ], "created_at": "2020-08-05T10:56:59.115769Z", "extension_reviewed": false, "id": "nginx/nginx-ingress-operator", "logo_url": "https://www.gravatar.com/avatar/6a6c67f4815a0379d3b697174b4f6805?s=80&r=g&d=mm", "media_types": [ "application/vnd.docker.container.image.v1+json", "application/vnd.docker.distribution.manifest.list.v2+json", "application/vnd.oci.image.index.v1+json" ], "name": "nginx/nginx-ingress-operator", "namespace": "nginx", "operating_systems": [ { "label": "Linux", "name": "linux" }, { "label": "unknown", "name": "unknown" } ], "publisher": { "id": "4fc42e3e74c011e4bea40242ac11001b", "name": "NGINX Inc." }, "pull_count": 1303739, "pull_count_display": "1M+", "repository": "nginx-ingress-operator", "short_description": "NGINX Ingress Operator for NGINX and NGINX Plus Ingress Controllers. Based on the Helm chart for NGI", "slug": "nginx/nginx-ingress-operator", "star_count": 4, "type": "image", "updated_at": "2026-10-02T13:17:21.07376Z", "url": "https://hub.docker.com/r/nginx/nginx-ingress-operator" }, { "additional_metadata": null, "architectures": [], "archived": false, "badge": "verified_publisher", "categories": [], "content_types": null, "created_at": "2023-03-20T10:04:32.72909316Z", "extension_reviewed": false, "id": "extension/nginx/docker-extension", "logo_url": "https://desktop.docker.com/extensions/nginx_docker-extension/raw_githubusercontent_com/nginx/docker-extension/main/logo.svg", "media_types": null, "name": "NGINX Development Center", "namespace": null, "operating_systems": [], "publisher": { "id": "", "name": "NGINX Inc." }, "pull_count": 60000, "pull_count_display": "50K+", "repository": null, "short_description": "NGINX Development Center for Docker Desktop", "slug": "nginx/docker-extension", "star_count": 0, "type": "extension", "updated_at": "2023-04-17T17:45:22.346709421Z", "url": "https://hub.docker.com/extensions/nginx/docker-extension" }, { "additional_metadata": null, "architectures": [ { "label": "x86-64", "name": "amd64" } ], "archived": false, "badge": "verified_publisher", "categories": [], "content_types": [ "image" ], "created_at": "2024-10-01T20:45:54.339343Z", "extension_reviewed": false, "id": "nginx/nginxaas-loadbalancer-kubernetes", "logo_url": "https://www.gravatar.com/avatar/6a6c67f4815a0379d3b697174b4f6805?s=80&r=g&d=mm", "media_types": [ "application/vnd.docker.container.image.v1+json" ], "name": "nginx/nginxaas-loadbalancer-kubernetes", "namespace": "nginx", "operating_systems": [ { "label": "Linux", "name": "linux" } ], "publisher": { "id": "4fc42e3e74c011e4bea40242ac11001b", "name": "NGINX Inc." }, "pull_count": 17411, "pull_count_display": "10K+", "repository": "nginxaas-loadbalancer-kubernetes", "short_description": null, "slug": "nginx/nginxaas-loadbalancer-kubernetes", "star_count": 1, "type": "image", "updated_at": "2026-01-15T19:00:53.632547Z", "url": "https://hub.docker.com/r/nginx/nginxaas-loadbalancer-kubernetes" }, { "additional_metadata": { "has_security_attestations": false }, "architectures": [], "archived": false, "badge": "verified_publisher", "categories": [ { "name": "API management", "slug": "api-management" }, { "name": "Security", "slug": "security" }, { "name": "Web servers", "slug": "web-servers" } ], "content_types": [ "helm", "image", "unrecognized" ], "created_at": "2023-01-24T10:50:59.733538Z", "extension_reviewed": false, "id": "bitnamicharts/nginx", "logo_url": "https://www.gravatar.com/avatar/85bcf547a6bf62b855df2c682af81a4e?s=80&r=g&d=mm", "media_types": [ "application/vnd.cncf.helm.config.v1+json", "application/vnd.oci.image.config.v1+json", "application/vnd.oci.image.index.v1+json", "application/vnd.vmware.tac.metadata.config.v1+json" ], "name": "bitnamicharts/nginx", "namespace": "bitnamicharts", "operating_systems": [], "publisher": { "id": "de99cb60826b4700a1f837a5c00621aa", "name": "VMware" }, "pull_count": 11377724, "pull_count_display": "10M+", "repository": "nginx", "short_description": "Bitnami Helm chart for NGINX Open Source", "slug": "bitnamicharts/nginx", "star_count": 4, "type": "image", "updated_at": "2026-09-30T10:23:31.924931Z", "url": "https://hub.docker.com/r/bitnamicharts/nginx" }, { "additional_metadata": { "has_security_attestations": false }, "architectures": [ { "label": "x86-64", "name": "amd64" }, { "label": "ARM 64", "name": "arm64" }, { "label": "ppc64le", "name": "ppc64le" }, { "label": "IBM Z", "name": "s390x" } ], "archived": false, "badge": "verified_publisher", "categories": [ { "name": "Web servers", "slug": "web-servers" } ], "content_types": [ "image" ], "created_at": "2020-11-23T13:21:13.865485Z", "extension_reviewed": false, "id": "ubuntu/nginx", "logo_url": "https://www.gravatar.com/avatar/4f24cbdaee59b3bc490c581e720accdb?s=80&r=g&d=mm", "media_types": [ "application/vnd.docker.distribution.manifest.list.v2+json", "application/vnd.oci.image.index.v1+json" ], "name": "ubuntu/nginx", "namespace": "ubuntu", "operating_systems": [ { "label": "Linux", "name": "linux" } ], "publisher": { "id": "57abbb9e74c011e4bea40242ac11001b", "name": "Canonical" }, "pull_count": 13044502, "pull_count_display": "10M+", "repository": "nginx", "short_description": "Nginx, a high-performance reverse proxy & web server. Long-term tracks maintained by Canonical.", "slug": "ubuntu/nginx", "star_count": 143, "type": "image", "updated_at": "2026-09-07T06:38:10.242871Z", "url": "https://hub.docker.com/r/ubuntu/nginx" }, { "additional_metadata": { "has_security_attestations": true }, "architectures": [ { "label": "x86-64", "name": "amd64" }, { "label": "ARM 64", "name": "arm64" } ], "archived": false, "badge": "verified_publisher", "categories": [ { "name": "Integration & delivery", "slug": "integration-and-delivery" }, { "name": "Security", "slug": "security" }, { "name": "Web servers", "slug": "web-servers" } ], "content_types": [ "image" ], "created_at": "2021-03-26T20:52:38.480315Z", "extension_reviewed": false, "id": "kasmweb/nginx", "logo_url": "https://www.gravatar.com/avatar/4ae97ef58b1f41ee117a830d31e4a1d1?s=80&r=g&d=mm", "media_types": [ "application/vnd.docker.distribution.manifest.list.v2+json", "application/vnd.oci.image.index.v1+json" ], "name": "kasmweb/nginx", "namespace": "kasmweb", "operating_systems": [ { "label": "Linux", "name": "linux" } ], "publisher": { "id": "e84141f727934f2cb65120b346ad251e", "name": "Kasm Technologies" }, "pull_count": 2753028, "pull_count_display": "1M+", "repository": "nginx", "short_description": "An Nginx image based off nginx:alpine and includes logrotate.", "slug": "kasmweb/nginx", "star_count": 9, "type": "image", "updated_at": "2026-10-05T07:08:41.10107Z", "url": "https://hub.docker.com/r/kasmweb/nginx" } ], "source_url": "https://hub.docker.com/api/search/v4?query=nginx&from=0&size=10", "total": 293848 } ```