Minecraft Skin API

API REST pour rechercher des joueurs Minecraft, generer des rendus de skins et telecharger des textures. Tous les endpoints sont accessibles publiquement sans authentification.

REST API

Public

Cache 5min

URL de base

https://your-domain.com/api/tools/minecraft-skin

Remplacez your-domain.com par le domaine de votre instance.

GET

/api/tools/minecraft-skin/player

Recherche un joueur Minecraft par pseudo ou UUID. Retourne les informations du joueur incluant les URLs du skin et de la cape.

Parametres

Nom	Type	Requis	Description
username	string	Optionnel	Pseudo du joueur (ex: Notch). Requis si uuid non fourni.
uuid	string	Optionnel	UUID du joueur (sans tirets). Requis si username non fourni.

Reponse

application/json

Exemple cURL

curl "https://your-domain.com/api/tools/minecraft-skin/player?username=Notch"

Exemple de reponse

{
  "success": true,
  "data": {
    "uuid": "069a79f444e94726a5befca90e38aaf5",
    "username": "Notch",
    "skinUrl": "https://textures.minecraft.net/texture/...",
    "capeUrl": null,
    "isSlim": false
  }
}

GET

/api/tools/minecraft-skin/mchead.png

Genere une image PNG de la tete du joueur en 2D. L'image est mise en cache cote serveur pendant 5 minutes.

Parametres

Nom	Type	Requis	Description
skin	string	Requis	UUID du joueur ou URL du skin.
width	number	Optionnel	Largeur de l'image en pixels (defaut: 160).
height	number	Optionnel	Hauteur de l'image en pixels (defaut: 160).

Reponse

image/png

Exemple cURL

curl -o head.png "https://your-domain.com/api/tools/minecraft-skin/mchead.png?skin=069a79f444e94726a5befca90e38aaf5"

GET

/api/tools/minecraft-skin/mcbody.png

Genere une image PNG du modele 3D complet du joueur. Supporte les rotations et le retournement.

Parametres

Nom	Type	Requis	Description
skin	string	Requis	UUID du joueur ou URL du skin.
width	number	Optionnel	Largeur de l'image en pixels (defaut: 300).
height	number	Optionnel	Hauteur de l'image en pixels (defaut: 400).
theta	number	Optionnel	Rotation horizontale en degres.
phi	number	Optionnel	Rotation verticale en degres.
time	number	Optionnel	Temps d'animation (pour la pose).
model	string	Optionnel	"slim" pour le modele Alex, "classic" pour Steve.
flip	boolean	Optionnel	Retourner horizontalement l'image.

Reponse

image/png

Exemple cURL

curl -o body.png "https://your-domain.com/api/tools/minecraft-skin/mcbody.png?skin=069a79f444e94726a5befca90e38aaf5&width=300&height=400"

GET

/api/tools/minecraft-skin/mcskin.png

Genere une image PNG 2D du skin complet (avant du personnage a plat).

Parametres

Nom	Type	Requis	Description
skin	string	Requis	UUID du joueur ou URL du skin.
width	number	Optionnel	Largeur de l'image en pixels.
height	number	Optionnel	Hauteur de l'image en pixels.

Reponse

image/png

Exemple cURL

curl -o skin.png "https://your-domain.com/api/tools/minecraft-skin/mcskin.png?skin=069a79f444e94726a5befca90e38aaf5"

GET

/api/tools/minecraft-skin/mccape.png

Genere une image PNG de la cape du joueur. Retourne une erreur si le joueur n'a pas de cape.

Parametres

Nom	Type	Requis	Description
skin	string	Requis	UUID du joueur.
width	number	Optionnel	Largeur de l'image en pixels.
height	number	Optionnel	Hauteur de l'image en pixels.

Reponse

image/png

Exemple cURL

curl -o cape.png "https://your-domain.com/api/tools/minecraft-skin/mccape.png?skin=069a79f444e94726a5befca90e38aaf5"

GET

/api/tools/minecraft-skin/texture/skin

Telecharge la texture PNG brute du skin (fichier 64x64 original de Minecraft).

Parametres

Nom	Type	Requis	Description
skin	string	Requis	UUID du joueur.

Reponse

image/png

Exemple cURL

curl -o texture-skin.png "https://your-domain.com/api/tools/minecraft-skin/texture/skin?skin=069a79f444e94726a5befca90e38aaf5"

GET

/api/tools/minecraft-skin/texture/cape

Telecharge la texture PNG brute de la cape du joueur.

Parametres

Nom	Type	Requis	Description
skin	string	Requis	UUID du joueur.

Reponse

image/png

Exemple cURL

curl -o texture-cape.png "https://your-domain.com/api/tools/minecraft-skin/texture/cape?skin=069a79f444e94726a5befca90e38aaf5"

GET

/api/tools/minecraft-skin/namehistory

Retourne l'historique des pseudos d'un joueur. Source: NameMC.

Parametres

Nom	Type	Requis	Description
uuid	string	Requis	UUID du joueur (sans tirets).

Reponse

application/json

Exemple cURL

curl "https://your-domain.com/api/tools/minecraft-skin/namehistory?uuid=069a79f444e94726a5befca90e38aaf5"

Exemple de reponse

{
  "uuid": "069a79f444e94726a5befca90e38aaf5",
  "source": "namemc",
  "names": [
    {
      "name": "Notch"
    }
  ]
}

GET

/api/tools/minecraft-skin/recent

Retourne la liste des 50 derniers skins recherches sur le site, tries par date decroissante.

Reponse

application/json

Exemple cURL

curl "https://your-domain.com/api/tools/minecraft-skin/recent"

Exemple de reponse

{
  "success": true,
  "skins": [
    {
      "uuid": "069a79f444e94726a5befca90e38aaf5",
      "username": "Notch",
      "searchedAt": "2026-01-15T12:00:00.000Z",
      "isSlim": false
    }
  ]
}

GET

/api/tools/minecraft-skin/featured

Retourne les skins populaires/trending. Scrapes depuis NameMC avec fallback sur une liste manuelle. Cache de 24h.

Reponse

application/json

Exemple cURL

curl "https://your-domain.com/api/tools/minecraft-skin/featured"

Exemple de reponse

{
  "success": true,
  "skins": [
    {
      "uuid": "069a79f444e94726a5befca90e38aaf5",
      "username": "Notch"
    }
  ],
  "source": "namemc",
  "cachedAt": "2026-01-15T12:00:00.000Z"
}

Nom

Type

Requis

Description

username

string

Optionnel

Pseudo du joueur (ex: Notch). Requis si uuid non fourni.

uuid

string

Optionnel

UUID du joueur (sans tirets). Requis si username non fourni.

{ "success": true, "data": { "uuid": "069a79f444e94726a5befca90e38aaf5", "username": "Notch", "skinUrl": "https://textures.minecraft.net/texture/...", "capeUrl": null, "isSlim": false } }

Nom

Type

Requis

Description

skin

string

Requis

UUID du joueur ou URL du skin.

width

number

Optionnel

Largeur de l'image en pixels (defaut: 160).

height

number

Optionnel

Hauteur de l'image en pixels (defaut: 160).

Nom

Type

Requis

Description

skin

string

Requis

UUID du joueur ou URL du skin.

width

number

Optionnel

Largeur de l'image en pixels (defaut: 300).

height

number

Optionnel

Hauteur de l'image en pixels (defaut: 400).

theta

number

Optionnel

Rotation horizontale en degres.

phi

number

Optionnel

Rotation verticale en degres.

time

number

Optionnel

Temps d'animation (pour la pose).

model

string

Optionnel

"slim" pour le modele Alex, "classic" pour Steve.

flip

boolean

Optionnel

Retourner horizontalement l'image.

Nom

Type

Requis

Description

skin

string

Requis

UUID du joueur ou URL du skin.

width

number

Optionnel

Largeur de l'image en pixels.

height

number

Optionnel

Hauteur de l'image en pixels.

Nom

Type

Requis

Description

skin

string

Requis

UUID du joueur.

width

number

Optionnel

Largeur de l'image en pixels.

height

number

Optionnel

Hauteur de l'image en pixels.

Nom

Type

Requis

Description

skin

string

Requis

UUID du joueur.

Nom

Type

Requis

Description

skin

string

Requis

UUID du joueur.

Nom

Type

Requis

Description

uuid

string

Requis

UUID du joueur (sans tirets).