Getting started
The quickest way to browse HeadDB or make your first API request.
Browse the catalog
Open Browse to search by name or numeric ID, restrict results to a category or tag, and choose an ordering. The complete filter state is stored in the URL, so a filtered view can be bookmarked or shared.
Each result provides shortcuts for its numeric ID and detail page. The detail page can also copy the /hdb give command, texture hash, and permanent link.
Make an API request
Public reads do not require an API key.
curl "https://headdb.net/api/v1/heads?q=dragon&limit=20"Responses use JSON. Paginated responses contain data and pagination objects. Invalid requests use application/problem+json with a stable type, status, and human-readable detail.
Stability
The supported API prefix is /api/v1. Additive response fields may appear without a version change. Removing or changing a field's meaning requires a new major API version.