This repository is effectively a mirror for the data made available by the Minecraft-Heads.com public API. The data is provided here as a single CSV file and is updated weekly by a script that runs on GitHub Actions.
To allow developers to fetch the entire dataset with a single HTTP call and without putting an unnecessary burden on the Minecraft-Heads.com servers. Used primarily by my own plugin, CreativeHeads.
The file is available via CDN, courtesy of jsDelivr:
https://cdn.jsdelivr.net/gh/TheLuca98/MinecraftHeads@master/heads.csv
Or you can click here: direct download link
The database is a standard CSV file. The first line is the header, which provides the names of the columns.
The tags column can either be empty (if the entry is not tagged) or contain one or more tags separated by |.
The value of the hash column is a portion of the skin URL: https://textures.minecraft.net/texture/<HASH>.
The skin URL is used to generate the textures property (to include in the user profile), which is essentially the following JSON object, but base64-encoded:
{ "textures": { "SKIN": { "url": "https://textures.minecraft.net/texture/<HASH>" } } }Additional resources on this topic: