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/100For avatars without the helm element, add
/nohelm to the end of any URL:
https://mc-heads.net/avatar/identifier/100/nohelmFor 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.pngIf 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 Usernames
We strongly advise you to use UUIDs instead of usernames! Usernames take longer to resolve, and are more likely to fail.
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 endpoints on MCHeads support UUIDs.
About Texture IDs
MCHeads support Minecraft Texture IDs as identifiers, Texture IDs may be any valid Minecraft texture hosted on textures.minecraft.net.
A Minecraft Texture's URL usually looks like this
http://textures.minecraft.net/texture/7fd9ba42a7c81eeea22f1524271ae85a8e045ce0af5a6ae16c6406ae917e68b5The Texture ID is the blue part
7fd9ba42a7c81eeea22f1524271ae85a8e045ce0af5a6ae16c6406ae917e68b5
Malformed texture IDs are rejected.
About Floodgate UUIDs
MCHeads supports Floodgate UUIDs as identifiers, allowing you to render Bedrock players playing on their Xbox Live accounts.
Malformed Floodgate UUIDs are rejected.
About Caching
MCHeads caches skins on its servers for 24 hours
CloudFlare also caches avatars for 6 hours, and will serve the cached version when available.
CORS
MCHeads supports Cross-Origin Resource Sharing, so you can make AJAX request from other sites!
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, feel free to ask in our Discord server.
Player search
Donations
Please consider donating for the continued support of MCHeads
Most requested usernames
| Name | Requests |
MHF_Steve
|
2,259,605 |
Mister_Fix 🔧
|
1,198,432 |
EinfxchLisa
|
722,351 |
Notch
|
721,180 |
geofeed
|
635,253 |
EinfxchJohn
|
599,698 |
RubbaBoy 💦😩
|
596,081 |
Schoko__
|
586,015 |
8blockluca
|
568,520 |
DarkEyeDragon ♥
|
549,949 |
0385
|
544,304 |
DasMaexle
|
529,089 |
leonfagan71 🛠
|
525,214 |
unlxqitjoma
|
524,320 |
Most searched usernames
| Name | Searches |
SenaKasa37
|
15,659 |
Fly_SS8
|
10,464 |
|
Mister_Fix 🔧
|
10,000 |
KYL_XiaoLongBao
|
7,787 |
artwhite
|
4,716 |
Tsuishun
|
3,239 |
BDark000
|
2,872 |
xmmune
|
2,699 |
sleepy_sapph
|
2,369 |
Tithox_
|
2,315 |
SirRevWhales
|
2,225 |
Jaxniss
|
2,220 |
sweeper777
|
2,149 |
TruckManiac
|
1,843 |
Who uses MCHeads
EuroParksMC.euPVPGym.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
TopEaglerServers.com
Are you using MCHeads? Tell us!