About MC Heads

Free Minecraft avatar API for everyone.

MC Heads is a free API for Minecraft player avatars, heads, and skins. It supports both Java and Bedrock Edition players.

◆ How it Works

The API fetches player data from Mojang (Java Edition) and GeyserMC (Bedrock Edition), processes the skin textures, and returns rendered images. Results are cached for 1 hour to ensure fast response times.

◆ Features

  • ✓ Java and Bedrock Edition support
  • ✓ Multiple render types (head, avatar, full body, skin)
  • ✓ Custom sizes from 16px to 512px
  • ✓ iOS-optimized endpoints
  • ✓ No API key required
  • ✓ No rate limits
  • ✓ CORS enabled for browser use

◆ Data Sources

Mojang API
Java Edition players
GeyserMC API
Bedrock Edition players

◆ Usage

The API is free to use for any purpose. No attribution required, though appreciated.

For Bedrock players, prefix the gamertag with a dot (e.g., .PlayerName).

DocumentationPlayground