About MC Heads

The story behind the free Minecraft avatar API

What is MC Heads?

MC Heads is a free, fast, and reliable API service that provides Minecraft player avatars, heads, and skins for both Java and Bedrock Edition players. Built for developers who need quick access to player renders without the complexity of handling Mojang's API directly.

Our service handles all the heavy lifting - from fetching player data from Mojang and GeyserMC APIs to processing and caching images for optimal performance. With over 1.2 million API calls served, we're trusted by developers worldwide.

Why Choose MC Heads?

🚀

Lightning Fast

1-hour intelligent caching ensures sub-100ms response times

🎮

Dual Edition Support

Java and Bedrock players with automatic detection

🖼️

Sharp Processing

Crisp, pixel-perfect scaling with Sharp image processing

🌐

CORS Ready

Full CORS support for web applications out of the box

💰

Completely Free

No API keys, rate limits, or hidden costs

📱

Mobile Optimized

Special iOS routes for mobile app development

Technical Architecture

Data Sources

  • Mojang API for Java Edition players
  • GeyserMC API for Bedrock Edition players
  • Automatic edition detection and fallback

Performance Features

  • 1-hour intelligent caching system
  • Sharp.js for high-quality image processing
  • CDN distribution for global availability

Usage Statistics

1.2M+
API Calls Served
99.9%
Uptime
<100ms
Avg Response
24/7
Availability

Common Use Cases

🌐

Web Applications

Display player avatars in Minecraft server websites, forums, and dashboards

📱

Mobile Apps

iOS and Android apps with optimized endpoints for mobile performance

🤖

Discord Bots

Show player heads and skins in Discord bot commands and embeds

🎮

Server Plugins

Minecraft server plugins for leaderboards and player profiles

📊

Analytics Tools

Minecraft statistics and analytics platforms with player visualization

🎨

Creative Projects

Art projects, wallpapers, and creative applications using player skins

Need Help or Have Questions?

Join our community or check out our resources