MCHeads

Extremely simple avatars

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

https://mc-heads.net/avatar/identifier/100

https://mc-heads.net/avatar/identifier/100/nohelm

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

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

Mojang API proxy

https://mc-heads.net/minecraft/profile/Name | UUID

MHF UUIDs

https://mc-heads.net/minecraft/mhf

About Caching

MCHeads caches skins on its servers for 6 hours
Images are also cached client side via cache headers for 2 hours.

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!

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.