Mineatar
A fast and efficient skin API for Minecraft
What is Mineatar?
Mineatar is an online API for developers and website owners that allows the embedding of Minecraft avatars as images, including faces, head renders, and full body renders. It is incredibly fast and supports all of the latest Minecraft features, like slim player models and overlays.
It is really easy to get started using our service: simply find the type of image that you are wanting to embed on your own website or service, and copy the URL. Replace the <uuid> text in the URL with the UUID of the Minecraft player, with or without hyphens, both are allowed.
Features
Incredibly fast
Our service is incredibly efficient and fast at rendering the skin of any Minecraft player, typically only in a couple of milliseconds once the skin is fetched on our end. We built our service using the Go programming language, a fast language that can handle large workloads like our own.
Efficient caching
Once a new player has been fetched once, the skin will be stored in the database of our server for up to a day. This allows any further renders to be fast, and we do not need to wait to fetch a new Minecraft skin from the Mojang API. After the cache has expired, the latest skin will be downloaded from Mojang during any new requests.
Custom scaling
Almost all of the routes support custom scaling, meaning you can change the dimensions of the image based on a scaling factor. Simply use the scale query parameter to change the scaling.
Overlay toggling
Every image route supports toggling the overlay (helmet) of the Minecraft skin being rendered. This allows you to view the player without this layer if it is necessary. It is enabled by default on all routes, but it can be disabled using query parameters. Refer to the query parameters section of the route documentation below.
Regular and slim models
In September of 2014, Mojang released a new variant of the Minecraft skin called slim (or "Alex") which allowed skins to have 3-pixel wide arms instead of the default 4. Our service will correctly render both models, keeping the same image dimensions regardless of which variant was rendered.
Open Source
Our service is entirely open source, allowing the developers in the community to make improvements and bug fixes on demand. This is also for transparency reasons, to openly show how the data you provide is used. If you would like to view the source code of our service, you can visit our GitHub organization page.
