# Docker API: Get container image details

> Gets public Docker Hub image details and the newest tags from an image name or Docker Hub page link. Signature and metadata artifact tags are omitted; size is the reported compressed tag size.

Unofficial. Not affiliated with or endorsed by Docker.

- Page: https://fous.com/methods/hub.docker.com/get-container-image
- Method: `hub.docker.com/get_container_image`, version 1
- Website: hub.docker.com
- Returns: image name, description, publisher, pulls, stars, dates, link, newest tags with size, architectures, digest
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `image` | string | yes | `"postgres"` | Image name or Docker Hub page link, for example postgres or https://hub.docker.com/r/bitnami/redis. A bare name is official. |
| `max_tags` | integer | no |  | Number of newest tags to show, for example 20. Default 20. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "image": "postgres"
}
```

Its output:

```json
{
  "link": "https://hub.docker.com/_/postgres",
  "tags": [
    {
      "link": "https://hub.docker.com/_/postgres/tags?name=19rc1-trixie",
      "name": "19rc1-trixie",
      "digest": "sha256:7c70c2455c1f22cf4fbf90b16345aa4e5f4e3efd68d68f7cd6d014f529a69108",
      "architectures": [
        "386",
        "amd64",
        "arm"
      ],
      "last_pushed_date": "2026-10-23",
      "compressed_size_mb": 164.23
    },
    {
      "link": "https://hub.docker.com/_/postgres/tags?name=19rc1",
      "name": "19rc1",
      "digest": "sha256:7c70c2455c1f22cf4fbf90b16345aa4e5f4e3efd68d68f7cd6d014f529a69108",
      "architectures": [
        "386",
        "amd64",
        "arm"
      ],
      "last_pushed_date": "2026-10-23",
      "compressed_size_mb": 164.23
    },
    {
      "link": "https://hub.docker.com/_/postgres/tags?name=17.11-alpine3.23",
      "name": "17.11-alpine3.23",
      "digest": "sha256:01ea903aa65deb58eb49d6e09d859ecff63a6bb7d61feca55f2abad71d08f72a",
      "architectures": [
        "386",
        "amd64",
        "arm"
      ],
      "last_pushed_date": "2026-10-22",
      "compressed_size_mb": 116.71
    }
  ],
  "stars": 15035,
  "publisher": "Docker Official Images",
  "image_name": "postgres",
  "description": "The PostgreSQL object-relational database system provides reliability and data integrity.",
  "total_pulls": 12003284669,
  "last_updated_date": "2026-10-23"
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"hub.docker.com/get_container_image","input":{"image":"postgres"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- What are the newest tags and compressed sizes for the nginx image on Docker Hub?
- Show me the publisher, pull count, and star rating for bitnami/redis on Docker Hub.
- I need the architectures and digest for the latest postgres image tags, limited to the 10 newest.
- Pull up the Docker Hub page details for https://hub.docker.com/r/grafana/grafana including description and last updated date.
- Get the 50 most recent tags for the python image on docker.com, with their sizes.

## Input schema

```json
{
  "type": "object",
  "required": [
    "image"
  ],
  "properties": {
    "image": {
      "type": "string",
      "minLength": 1,
      "description": "Image name or Docker Hub page link, for example postgres or https://hub.docker.com/r/bitnami/redis. A bare name is official."
    },
    "max_tags": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Number of newest tags to show, for example 20."
    }
  },
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "image_name",
    "description",
    "publisher",
    "total_pulls",
    "stars",
    "last_updated_date",
    "link",
    "tags"
  ],
  "properties": {
    "link": {
      "type": "string",
      "description": "Docker Hub image page."
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "compressed_size_mb",
          "architectures",
          "last_pushed_date",
          "digest",
          "link"
        ],
        "properties": {
          "link": {
            "type": "string",
            "description": "Docker Hub tag page."
          },
          "name": {
            "type": "string",
            "description": "Tag name."
          },
          "digest": {
            "type": [
              "string",
              "null"
            ],
            "description": "Tag manifest digest.",
            "x-fous-developer": true
          },
          "architectures": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Available architectures; empty when not reported."
          },
          "last_pushed_date": {
            "type": [
              "string",
              "null"
            ],
            "description": "Last pushed date, YYYY-MM-DD."
          },
          "compressed_size_mb": {
            "type": [
              "number",
              "null"
            ],
            "description": "Reported compressed tag size in decimal megabytes."
          }
        },
        "additionalProperties": false
      },
      "description": "Newest image tags first, excluding publisher signature and metadata artifact tags."
    },
    "stars": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Number of stars."
    },
    "publisher": {
      "type": [
        "string",
        "null"
      ],
      "description": "Publisher name."
    },
    "image_name": {
      "type": "string",
      "description": "Image name; official images omit the library namespace."
    },
    "description": {
      "type": [
        "string",
        "null"
      ],
      "description": "Short description."
    },
    "total_pulls": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Lifetime pull count."
    },
    "last_updated_date": {
      "type": [
        "string",
        "null"
      ],
      "description": "Last updated date, YYYY-MM-DD."
    }
  },
  "additionalProperties": false
}
```

## See more

- [Docker API: Search container images](https://fous.com/methods/hub.docker.com/search-container-images.md): Finds public Docker Hub container images matching a software name, in Docker Hub search order, with publisher, badge, stars, last update and exact total pulls when Docker Hub publishes them. Can keep only Docker Official Images and Verified Publisher images.
- [RubyGems API: Get a Ruby gem's details](https://fous.com/methods/rubygems.org/get-gem.md): Looks up a Ruby gem on RubyGems by name or gem page link and returns its latest version, release date, description, downloads, authors, license, links and runtime dependencies.
- [PyPI API: Get package](https://fous.com/methods/pypi.org/get-package.md): Gets a PyPI package's current version, release date, metadata, project links and its 10 most recently published versions from a package name or PyPI link.
- [YouTube API: Get video](https://fous.com/methods/youtube.com/get-video.md): Gets public details and statistics for one YouTube video by link, ID or title. A title selects the top search match.
- [GitHub API: List releases](https://fous.com/methods/github.com/list-releases.md): Lists published, non-draft releases of a public GitHub project, newest first. A bare project name matches the most-starred repository.
- [Wikimedia Commons API: Search free images](https://fous.com/methods/commons.wikimedia.org/search-free-images.md): Finds free-to-use Wikimedia Commons images for a topic in Commons relevance order. Each image comes with its links, creator and licence details.
- [IMDb API: Get movie or show](https://fous.com/methods/imdb.com/get-movie-or-show.md): Gets a movie or TV show's IMDb details from its name, IMDb title link or title ID; a year picks between titles with the same name. Unavailable details are null.
- [npm API: Get package](https://fous.com/methods/npmjs.com/get-package.md): Looks up a public npm package by name or npm link. Returns its latest version, weekly downloads, maintainers, links, dates and version count.
- [All Docker methods](https://fous.com/methods/docker.com.md)