About the Project

About MC Heads

Free Minecraft avatar API for everyone.

Notchjeb_Dinnerbone

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

Java Edition

Mojang API

Official source for Java Edition player skins and data.

Bedrock Edition

GeyserMC API

Community-driven source for Bedrock Edition player data.

Usage

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

For Bedrock players, prefix the gamertag with a dot: .PlayerName

DocumentationPlaygroundSource Code