Discord
Join our new and better Discord server right here!Extremely simple avatars
The examples shown below work with all avatar types.For basic usage just provide a UUID or a username:
https://mc-heads.net/avatar/UUIDFor size control, add the desired size in pixels after specifying the username:
https://mc-heads.net/avatar/UUID/100For avatars without the helm element, add
/nohelm
to the end of any URL:
https://mc-heads.net/avatar/UUID/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/UUID/100/nohelm.png
8px up to 600px
Isometric Head
https://mc-heads.net/head/UUID
32px up to 600px
Isometric Body
https://mc-heads.net/body/UUID
32px up to 600px
Full body
https://mc-heads.net/player/UUID
8px up to 600px
Combo avatar
https://mc-heads.net/combo/UUID
8px up to 600px
Cape:
https://mc-heads.net/cape/UUIDIf the player does not own a cape, an
HTTP/1.1 404 Not Found
status code will be returned.
Default skins:
https://mc-heads.net/avatar/MHF_Steve
https://mc-heads.net/avatar/MHF_Alex
Get skin:
https://mc-heads.net/skin/UUID
Download skin:
https://mc-heads.net/download/UUID
Direct skin switch:
https://mc-heads.net/change/UUID
Mojang API:
This endpoint caches requests to the mojang api letting you request a profiles without a rate limit.Username history is also sent.
Valid profiles are cached for 4 hours.
https://mc-heads.net/minecraft/profile/[username or UUID]If username/UUID is malformed, an
HTTP/1.1 204 No content
status code will be returned.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_uuids
About Caching
MCHeads caches skins on its servers for 36 hours
Images are also cached client side via cache headers for 36 hours. Once
Changed skins do not take effect on MCHeads immediately.
MCHeads deletes expired server side cache every 5 minutes.
About Usernames
We strongly advise you to use UUIDs instead of usernames! UUIDs never change while usernames do.
Looking up players by username has officially been deprecated by Mojang ever since UUIDs were introduced.
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!
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.
HTTP Headers
Responses come with some custom HTTP headers, useful for debugging.
Please note that these headers may be cached by CloudFlare.
-
X-Has-Failed: Details about the request status
- true: The request went well, there were no issues on both sides.
- false: couldn't reach mojang's services or a malfored UUID/Name was requested.
Support
To contact us about any issue, please send an E-Mail to support@mc-heads.net, or ask in our Discord server.
Most requested usernames
Name | Requests |
![]() |
3,644,527 |
![]() |
629,831 |
![]() |
344,763 |
![]() |
275,373 |
![]() |
266,891 |
![]() |
240,758 |
![]() |
229,214 |
![]() |
226,580 |
![]() |
197,486 |
![]() |
188,721 |
![]() |
184,024 |
![]() |
159,984 |
![]() |
142,936 |
![]() |
141,691 |
Most searched usernames
Name | Searches |
![]() |
1,364 |
![]() |
826 |
![]() |
711 |
![]() |
411 |
![]() |
295 |
![]() |
233 |
![]() |
199 |
![]() |
178 |
![]() |
171 |
![]() |
143 |
![]() |
139 |
![]() |
126 |
![]() |
120 |
![]() |
116 |
Who uses MCHeads
LearnToMod.comServerMiner.com
BDcraft.net
Litebans Material UI
PigParty.eu
heads.freshcoal.com
IronCreeper.com
tkjk.cz
skins.snowdev.com.br
Are you using MCHeads? Tell us!
Tools
VanillaForums avatars pluginVanillaForums heads plugin
MCPacks - resource pack hosting CDN