Explore the DarkerDB API documentation, your gateway to harnessing Dark and Darker game data. Use our APIs to track in-game market trends, analyze live player stats, and access detailed item data, including stats, descriptions, and market data. Download game assets like item icons to enhance your apps or generate interactive tooltips. Feel free to get in touch with us in our Discord for support or to request new features or data!

Facets

Facets are the API's enum dictionary. Every low-cardinality field (rarities, kinds, types, slots, and so on) is published as a stable list of { value, label } records, the same shape for every facet and every tier. Filter params like &rarity only accept values from their facet, so fetch /v2/facets once at boot and bind your dropdowns to it instead of hard-coding the members. The dictionary is rebuilt from the live tables on every refresh, so new values from future patches appear automatically.

Item and monster responses carry raw slugs only ("rarity": "rare"). The display label ("Rare") is shared by hundreds of rows, so the API leaves it out and lets render-time UIs look it up from the dictionary.

GET /v2/facets

The full dictionary. Returns every facet keyed by name under facets, each carrying its values plus a description and an auth_required flag.

Response shape: { facets: { <name>: { name, description, auth_required, values: [ { value, label } ] } } }.

GET/v2/facets

GET /v2/facets/{name}

&name = Pick a facet from the dictionary

One facet by name. Same record as above, returned under facet.

GET/v2/facets/{name}

name (path)

GET /v2/facets/{name}/{value}

&name = Pick a facet from the dictionary

&value = A value within the chosen facet (type one from its values list)

Example: rare

A single value record, returned under value.

GET/v2/facets/{name}/{value}

name (path)

value (path)

GET /v2/facets/ids/{type}

&type = Pick an entity type

An id facet. Where an enum facet lists a handful of static values, an id facet lists every entity of one kind as { value, label }: the canonical id plus its display name. This is the lexicon that powers the id-picker dropdowns and prose auto-linking. Rows are sorted by label; entities whose name can't be resolved are omitted.

Rows also carry an icon_url (an absolute CDN url for the entity's icon) whenever the catalog stores one, so an embed can paint an inline icon straight from the CDN. Items add a meta rarity slug, and quests add their title-derived slug (the page URL, which the mechanical id can't reconstruct). Each is present only when it applies.

Supported {type} values: monster, class, merchant, spell, perk, skill, map, item, religion, emote, attribute, song, shape_shift, module, dungeon, quest, container, patch and leaderboard. An unknown type returns 404.

GET/v2/facets/ids/{type}

type (path)