Minecraft Skin API
Render profile pictures, heads, bodies and chests — or fetch raw skin data for any Minecraft player. No auth required.
GET /api/pfp/{username}.png Returns a generated profile picture as PNG.
Parameters
| Name | In | Description |
|---|
username | path | Minecraft username (1–16 characters) |
gradient | query | Hex colors separated by - e.g. ff0000-0000ff |
transparent | query | Set to true for transparent background |
Examples
GET /api/pfp/TinyBrickBoy.png
GET /api/pfp/TinyBrickBoy.png?gradient=da4167-1b2531
GET /api/pfp/TinyBrickBoy.png?transparent=true
GET /api/body/{username}.png Returns a full-body front-view render.
Parameters
| Name | In | Description |
|---|
username | path | Minecraft username (1–16 characters) |
size | query | Output height in pixels (32–1024), default 256. Width scales proportionally (1:2 ratio). |
overlay | query | Set to false to hide hat & armor layers |
Examples
GET /api/body/TinyBrickBoy.png
GET /api/body/TinyBrickBoy.png?size=512
GET /api/body/TinyBrickBoy.png?overlay=false
GET /api/chest/{username}.png Returns a torso + arms render (no head, no legs).
Parameters
| Name | In | Description |
|---|
username | path | Minecraft username (1–16 characters) |
size | query | Output height in pixels (12–1024), default 128 |
overlay | query | Set to false to hide armor layer |
Examples
GET /api/chest/TinyBrickBoy.png
GET /api/chest/TinyBrickBoy.png?size=256
GET /api/skin/{username}.png Returns the raw Minecraft skin texture as PNG.
Parameters
| Name | In | Description |
|---|
username | path | Minecraft username (1–16 characters) |
Example
GET /api/skin/TinyBrickBoy.png
GET /api/head/{username}.png Returns a rendered 2D face with hat layer.
Parameters
| Name | In | Description |
|---|
username | path | Minecraft username (1–16 characters) |
size | query | Output size in pixels (8–512), default 128 |
overlay | query | Set to false to hide the hat layer |
Examples
GET /api/head/TinyBrickBoy.png
GET /api/head/TinyBrickBoy.png?size=256
GET /api/head/TinyBrickBoy.png?overlay=false
GET /api/uuid/{username}.json Returns the UUID for a given username.
Parameters
| Name | In | Description |
|---|
username | path | Minecraft username (1–16 characters) |
Example
GET /api/uuid/TinyBrickBoy.json
Response 200 OK
{
"username": "TinyBrickBoy",
"uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
GET /api/mojang/{username}.json Returns skin data as a base64-encoded data URL.
Parameters
| Name | In | Description |
|---|
username | path | Minecraft username (1–16 characters) |
Example
GET /api/mojang/TinyBrickBoy.json
Response 200 OK
{
"skin": "data:image/png;base64,..."
}