Get avatars from Minecraft

Resolve user avatars against minecraft.net with a single URL. No API keys, no SDK — just unavatar.io/minecraft/{input}.

unavatar.io/minecraft/

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

Start for free Documentation

Why this page exists

When to use the Minecraft avatar API

This page is built for developers comparing ways to resolve Minecraft avatars by Java Edition username or UUID. 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 Minecraft Java Edition player's face by their username or UUID.

Useful when you need a stable Minecraft 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

Minecraft API usage

Get any Minecraft Java Edition player's face by their username or UUID.

unavatar.io/minecraft/{username}

Get Minecraft profile picture by username

unavatar.io/minecraft/{id}

Get Minecraft profile picture by uuid

Use cases

Good fits for Minecraft 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 Minecraft in one request

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

Build the URL

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

https://unavatar.io/minecraft/

Get the avatar

unavatar fetches the image from minecraft.net.

Avatar resolved

Provider: Minecraft

<img src="https://unavatar.io/minecraft/notch" />

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 Minecraft avatar?

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

Is the Minecraft 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 Minecraft 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 Minecraft?

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.