Get avatars from Docker Hub

Resolve user avatars against hub.docker.com with a single URL. No API keys, no SDK — just unavatar.io/dockerhub/{input}.

unavatar.io/dockerhub/

<img src="https://unavatar.io/dockerhub/username" />

Start for free Documentation

Why this page exists

When to use the Docker Hub avatar API

This page is built for developers comparing ways to resolve Docker Hub avatars by username or organization. It explains what makes this provider useful, what kind of inputs it supports, and when you may want to call this provider directly instead of relying on a broader fallback chain.

Get any Docker Hub user's profile picture by username or organization.

Useful when you need a stable Docker Hub avatar URL in apps, docs, demos, or account directories.

Works with a straightforward URL pattern so you can integrate it without an SDK or custom client.

API reference

Docker Hub API usage

Get any Docker Hub user's profile picture by username or organization.

unavatar.io/dockerhub/{username}

Get Docker Hub profile picture by username

Use cases

Good fits for Docker Hub lookups

Rendering account avatars in dashboards, comments, and member directories.

Generating social previews, changelogs, and docs examples from a predictable image endpoint.

Reducing custom integration code by keeping avatar lookups behind one URL structure.

How it works

Get avatars from Docker Hub in one request

Build a URL with the Docker Hub endpoint and your input, then fetch the image. No API keys required for the free tier.

Build the URL

Start from unavatar.io/dockerhub/ and add the input that provider expects.

https://unavatar.io/dockerhub/

Get the avatar

unavatar fetches the image from hub.docker.com.

Avatar resolved

Provider: Docker Hub

<img src="https://unavatar.io/dockerhub/tensorflow" />

Cached & optimized

Responses are cached for up to 24 hours. Subsequent requests return instantly — no redundant upstream lookups.

HTTP/1.1 200 OK

content-type: image/png

cache-control: public, max-age=86400

x-cache-status: HIT

x-pricing-tier: pro

x-proxy-tier: origin

x-unavatar-cost: 1

x-rate-limit-limit: 50

x-rate-limit-remaining: 49

Read the docs

More providers

unavatar works with 99+ platforms

Resolve avatars (and related images) from GitHub, X, Instagram, Spotify, and more with the same simple API.

← All providers

Built for scale

Track avatar API usage, top providers, and billing in one dashboard.

See request trends, platform mix, error rates, and billing insights in a single view so teams can move faster without guesswork.

View live demo

Unavatar dashboard showing usage charts, token consumption, top providers, and billing overview. — Dashboard preview with API requests, platform split, and transfer metrics.

Last 30 days235.8MAvatars resolved

Performant and proven to handle scale, every day.

No less than67%CDN cache ratio

Fast responses backed by a global edge network you can count on.

Last 30 days2 TBData served

Proudly serving companies from small to large every day.

Simple transparent pricing

Pricing, made simple

Pure pay-as-you-go. No minimums, no commitments — you only pay for what you use. Cached requests are served for free and don't count toward your usage.

1,000 reqs/moestimated cost$10/mo

1K10K100K1M

Get startedNo subscription. Billed monthly based on usage.

99+ providers

Edge-cached responses

API key access

Custom fallbacks

Custom TTL

JSON & image formats

Priority support

SLA guarantee

Free tier includes 25 requests/day for unauthenticated traffic and 50 requests/day for authenticated (API key) traffic.

Trusted by developers

From developers to teams like you

See how teams use unavatar to power profile and account experiences.

Carlos HernándezPrincipal Engineer at Plato

Germán RodríguezFull Stack Engineer at Plain Concepts

Joseba LegarretaProduct Lead at Microlink

Frequently Asked Questions

How do I get a Docker Hub avatar?

Make a GET request to unavatar.io/dockerhub/{username or organization}. The API returns the image directly — no SDK or API tokens required.

Is the Docker Hub API free?

Yes. The free tier allows 25 requests per day per IP with no API key, and 50 requests per day with an API key. For higher volume, paid usage is metered with no minimums or subscriptions.

What if my Docker Hub avatar lookup returns nothing?

A default fallback image is returned automatically. You can pass a custom fallback URL as a query parameter: ?fallback=https://your-fallback.com/image.png.

Can I resolve images from other providers besides Docker Hub?

Yes. unavatar supports 99+ providers including GitHub, X, Instagram, Gravatar, Spotify, and more. Every provider uses the same unavatar.io/{provider}/{key} pattern.

How fast are responses?

Cached responses are served from the edge in under 50ms. Fresh lookups depend on the upstream provider but typically resolve in under 300ms. All responses are cached on a global CDN.