0 Avatars served

Extremely simple avatars


For basic usage just provide an identifier - A UUID, Floodgate UUID, username or a Minecraft texture ID:
https://mc-heads.net/avatar/identifier
For size control, add the desired size in pixels after specifying the username:
https://mc-heads.net/avatar/identifier/100
For avatars without the helm element, add /nohelm to the end of any URL:
https://mc-heads.net/avatar/identifier/100/nohelm
For a URL with a file extension, you can add a .png at the very end of any URL:
https://mc-heads.net/avatar/identifier/100/nohelm.png
If you wish to use a Minecraft Texture to render an avatar, you can simply replace the identifier with the texture ID:
https://mc-heads.net/avatar/bedbdec6f125cb5fb28cc717fd37260f7395c0ac60152d1758aab966c3539825/100

8px up to 600px




Isometric Avatars

https://mc-heads.net/head/identifier
https://mc-heads.net/body/identifier

Isometric avatars' facing direction can be changed with a modifier at the end of the URL:
https://mc-heads.net/body/identifier/<left/right>

32px up to 600px



Full body

https://mc-heads.net/player/identifier

8px up to 600px



Combo avatar

https://mc-heads.net/combo/identifier

8px up to 600px



Default skins

https://mc-heads.net/avatar/MHF_Steve
https://mc-heads.net/avatar/MHF_Alex


Get a player's skin

https://mc-heads.net/skin/identifier

Download a player's skin

https://mc-heads.net/download/identifier

MHF UUIDs

Mojang has created several accounts with guaranteed static skins to help map makers visualize their creations with said account's heads.
This endpoint attempts to list all of the known and verified MHF UUIDs and their names.
https://mc-heads.net/minecraft/mhf


About Caching

MCHeads caches skins on its servers for 24 hours
Images are also cached in your browser for 2 hours.
In addition, CloudFlare may cache images as long as your browser would.


About Usernames

We strongly advise you to use UUIDs instead of usernames! UUIDs never change while usernames do.

Malformed usernames are rejected.


About UUIDs

UUIDs may be any valid Mojang UUID in the blank or dashed format.
Malformed UUIDs are rejected, and all features on MCHeads support UUIDs


CORS

MCHeads supports Cross-Origin Resource Sharing, so you can make AJAX request from other sites!


HTTP/2

MCHeads supports HTTP/2, meaning a client can re-use a single underlying TCP connection to make multiple requests instead of opening a new connection for each one, making the whole process up to 50% faster!
If you are using one of the JSON or avatar endpoints of MCHeads, using HTTP/2 could heavily increase performance in your app.


Attribution

Attribution is not required, but it is encouraged.
If you want to show some support for this (free!) service, place a notice like this somewhere: Thanks to <a href="https://mc-heads.net">MCHeads</a> for providing Minecraft avatars.



Support

To contact us about any issue, please send an E-Mail to [email protected], or ask in our Discord server.


Donations

Please consider donating for the continued support of MCHeads

DigitalOcean Logo

Most requested usernames

Name Requests
Mister_Fix 🔧 1,173,105
EinfxchLisa 719,066
Notch 670,054
CAEC64 615,852
EinfxchJohn 596,999
RubbaBoy 💦😩 592,900
ScoutingForSued 583,093
8blockluca 565,822
DarkEyeDragon 547,246
0385 541,475
DasMaexle 527,040
leonfagan71 🛠 522,291
unlxqitjoma 521,735
SpiritOfMoon 356,066

Most searched usernames

Name Searches
Mister_Fix 🔧 7,837
Notch 3,730
xmmune 2,672
sleepy_sapph 2,331
Tithox_ 2,291
BDark000 2,266
SirRevWhales 2,199
Jaxniss 2,192
happy_ness 1,795
morbius100 1,701
RapunzeLin 1,691
Shy0 1,642
LILBurpy 1,522
NeedABG 1,503

Who uses MCHeads

PVPGym.net
NamelessMC CMS
iOS MC Status Widget app
Minecraft.buzz
MCChecker.net
EliteBot
Enchant.pl
skins.snowdev.com.br
InteractiveChat DiscordSRV Addon
Store.Minecadia.com
Are you using MCHeads? Tell us!

Tools

MCPacks - resource pack hosting CDN

MCHeads © 2013 - 2025 – All rights reserved

Back to top