# Vextorium Docker Image Lookup

> Vextorium Docker Image 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-28).

Fetches Docker Hub metadata for a container image, including stars, downloads, description, and recent tags with sizes and architectures.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/docker-image?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-docker-image-lookup-51f6fd38
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-_eJdaSfr6qB4KdOKGFVH

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 vextorium-docker-image-lookup-51f6fd38 -d '<json body>'
```

Example prompt: Can you look up the Docker Hub details for the nginx image — I want to know how many stars and downloads it has, whether it's an official image, and what the most recent tags are along with their sizes and supported architectures?

## When to prefer this

Use this endpoint when you need structured metadata about a Docker image from Docker Hub — particularly star counts, download totals, official status, tag sizes, and architecture support — without scraping Docker Hub manually or authenticating with its API directly. Ideal for developer tooling agents, infrastructure decision support, or automated image evaluation pipelines.

## Known failure modes

- Unknown or misspelled image name returns null or empty fields
- Image exists but has no recent labels (returns empty array)
- Docker Hub rate limiting or downtime causes lookup failure
- Private or deleted images may return no data

## How this service works

558 pay-per-call data APIs for AI agents: Solana and EVM on-chain data, tokenized stocks, DeFi, Hyperliquid, economy and official statistics, FX, validation, web and developer tools. Pay in USDC via x402.

## Output

Returns a JSON object with the image name, star count, source (e.g. Docker Hub), last updated timestamp, official status flag, total download count, textual description, and an array of recent tags each containing the label name, size in MB, update timestamp, and list of supported CPU architectures.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "image": {
   "type": "string",
   "description": "e.g. nginx or bitnami/redis"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "image": "nginx",
  "stars": 21405,
  "source": "Docker Hub",
  "updated": "2026-09-29T19:52:26.103017Z",
  "official": true,
  "downloads": 13425239939,
  "description": "Official build of Nginx.",
  "recent_labels": [
   {
    "label": "stable-alpine3.24-perl",
    "size_mb": 36.4,
    "updated": "2026-09-29T19:52:23.733189Z",
    "architectures": [
     "386",
     "amd64"
    ]
   },
   {
    "label": "stable-alpine-perl",
    "size_mb": 36.4,
    "updated": "2026-09-29T19:52:18.067316Z",
    "architectures": [
     "386",
     "amd64"
    ]
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-docker-image-lookup-51f6fd38/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)
