McHeads Documentation

Minecraft Avatar Showcase

Default

Minecraft Default Avatar

https://api.mcheads.org/head/Person98

100px

Minecraft 100px Avatar

https://api.mcheads.org/head/Person98/100

No Helm

Minecraft No Helm Avatar

https://api.mcheads.org/head/Person98/100/nohelm

Usage Instructions:

For basic usage, provide an identifier - UUID, username, or a Minecraft texture ID:

  • https://api.mcheads.org/head/Person98
  • https://api.mcheads.org/head/Person98/100
  • https://api.mcheads.org/head/Person98/100/nohelm

For a URL with a file extension, add .png at the very end of any URL.

Minecraft Isometric Avatar Showcase

Head

Minecraft Head Avatar

https://api.mcheads.org/ioshead/Person98

Body

Minecraft Body Avatar

https://api.mcheads.org/iosbody/Person98

Full Body

Minecraft Full Body Avatar

https://api.mcheads.org/player/person98

Usage Instructions:

For basic usage, provide an identifier - UUID, username, or a Minecraft texture ID:

  • https://api.mcheads.org/ioshead/Person98
  • https://api.mcheads.org/iosbody/Person98
  • https://api.mcheads.org/player/person98

For a URL with a file extension, add .png at the very end of any URL.

MCHeads.org Info

Caching

  • Skins cached on servers for 24 hours
  • Images cached in browser for 2 hours
  • CloudFlare caches as long as your browser

Usernames

Use UUIDs instead of usernames to avoid issues.

Malformed usernames are rejected.

UUIDs

  • Valid Mojang UUIDs in blank or dashed format
  • Malformed UUIDs are rejected

CORS

Supports Cross-Origin Resource Sharing (CORS).

HTTP/2

Supports HTTP/2 for faster performance.

Use HTTP/2 with JSON or avatar endpoints for better performance.

Attribution

Attribution encouraged but not required.

Support us by adding: Thanks to MCHeads.org for providing Minecraft avatars.

Mcheads.org is officially used by

Ace MC Logo
Blaze Gaming Logo

Trusted by top gaming communities