# Docker Hub Image Profile Lookup

> Docker Hub Image Profile Lookup is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-13).

Fetches metadata for a Docker Hub image including description, stars, total pulls, last update, and recent tags with size and architectures.

## Facts

- Endpoint: POST https://api.vextorium.com/docker-imagen-pago?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/docker-hub-image-profile-lookup-b54efc56
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QRygfOnnuVls0bZOmlbGu

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability docker-hub-image-profile-lookup-b54efc56 -d '<json body>'
```

Example prompt: Can you look up the Docker Hub profile for the nginx image and tell me how many pulls it has, its star count, and what the most recent tags are along with their supported architectures?

## When to prefer this

Use this endpoint when you need structured, rich metadata about a Docker Hub image — including pull counts, stars, tags, sizes, and architectures — without scraping Docker Hub directly. Ideal for DevOps agents vetting images before deployment, monitoring image freshness, or building dashboards about container image usage. Prefer this over manual Docker CLI or web scraping when you need programmatic, structured data.

## Known failure modes

- Image not found on Docker Hub — returns null or error response
- Invalid image name format — schema requires a valid string like 'nginx' or 'bitnami/redis'
- Docker Hub API rate limiting or downtime — upstream service unavailable
- Typo in image name results in no data returned
- Private or restricted images may not return full metadata

## How this service works

Docker Hub image profile (official or user): description, stars, total pulls, last update and recent tags with size and architectures.

## Output

A JSON object containing: the source (Docker Hub), image name, whether it is an official image, total download count, star count, last updated timestamp, a text description, and an array of recent tags each with their tag name, size in MB, last updated date, and list of supported CPU architectures.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "required": [
      "imagen"
     ],
     "properties": {
      "imagen": {
       "type": "string",
       "description": "e.g. nginx or bitnami/redis"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": [
      "object",
      "null"
     ],
     "properties": {
      "fuente": {
       "type": [
        "string",
        "null"
       ]
      },
      "imagen": {
       "type": [
        "string",
        "null"
       ]
      },
      "oficial": {
       "type": [
        "boolean",
        "null"
       ]
      },
      "descargas": {
       "type": [
        "number",
        "null"
       ]
      },
      "estrellas": {
       "type": [
        "number",
        "null"
       ]
      },
      "actualizada": {
       "type": [
        "string",
        "null"
       ]
      },
      "descripcion": {
       "type": [
        "string",
        "null"
       ]
      },
      "etiquetas_recientes": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": [
         "null",
         "object"
        ],
        "properties": {
         "etiqueta": {
          "type": [
           "null",
           "string"
          ]
         },
         "tamano_mb": {
          "type": [
           "null",
           "number"
          ]
         },
         "actualizada": {
          "type": [
           "null",
           "string"
          ]
         },
         "arquitecturas": {
          "type": [
           "array",
           "null"
          ],
          "items": {
           "type": [
            "null",
            "string"
           ]
          }
         }
        }
       }
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "fuente": "Docker Hub",
  "imagen": "nginx",
  "oficial": true,
  "descargas": 13425239939,
  "estrellas": 21405,
  "actualizada": "2026-09-29T19:52:26.103017Z",
  "descripcion": "Official build of Nginx.",
  "etiquetas_recientes": [
   {
    "etiqueta": "stable-alpine3.24-perl",
    "tamano_mb": 36.4,
    "actualizada": "2026-09-29T19:52:23.733189Z",
    "arquitecturas": [
     "386",
     "amd64"
    ]
   },
   {
    "etiqueta": "stable-alpine-perl",
    "tamano_mb": 36.4,
    "actualizada": "2026-09-29T19:52:18.067316Z",
    "arquitecturas": [
     "386",
     "amd64"
    ]
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/docker-hub-image-profile-lookup-b54efc56/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)