Extremely simple avatars
For basic usage just provide an identifier - 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/100For avatars without the helm element, add
/nohelm
to the end of any URL:
https://mc-heads.net/avatar/identifier/100/nohelmAnd 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
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/UUID
Download a player's skin
https://mc-heads.net/download/UUID
Switch your skin to a player's skin
https://mc-heads.net/change/UUID
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.
Most requested usernames
Name | Requests |
Mister_Fix 🔧 | 1,142,100 |
EinfxchLisa | 714,125 |
Notch | 638,178 |
mcKinocubeOrg | 611,260 |
EinfxchLukas | 592,835 |
RubbaBoy 💦😩 | 588,600 |
ScoutingForSued | 578,628 |
8blockluca | 561,357 |
DarkEyeDragon ♥ | 542,462 |
0385 | 537,063 |
DasMaexle | 522,385 |
unlxqitjoma | 517,574 |
leonfagan71 🛠 | 517,352 |
SpiritOfMoon | 351,712 |
Most searched usernames
Name | Searches |
Mister_Fix 🔧 | 6,386 |
Notch | 3,175 |
xmmune | 2,632 |
Tithox_ | 2,270 |
SirRevWhales | 2,185 |
Jaxniss | 2,174 |
happy_ness | 1,772 |
morbius100 | 1,676 |
RapunzeLin | 1,670 |
Shy0 | 1,630 |
Derpymin_ | 1,500 |
znra | 1,488 |
baidreal | 1,418 |
Nexus_OG | 1,395 |
Who uses MCHeads
NamelessMC CMSiOS MC Status Widget app
Minecraft.buzz
MCChecker.net
EliteBot
OrchidMC.me
Enchant.pl
Rinaorc.com
BDcraft.net
skins.snowdev.com.br
InteractiveChat DiscordSRV Addon
Oreatoria.fr
PixelSquad.fr
Store.Minecadia.com
Are you using MCHeads? Tell us!