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!

Maps

Game maps with spawn-point metadata and minimap imagery. Extracted from the game's .pak files every patch. Always reflects the current patch.

Each row is a DungeonType — a single family / game-mode combination. The type column carries the family (crypts, goblin, …) and variant carries the mode (adventure, high_roller, normal, …). Every row includes a display_name — the locale-resolved name with the variant appended in parentheses for disambiguation, e.g. "The Forgotten Castle (High Roller)". Falls back to the titleized type + variant when the locale key doesn't resolve, e.g. "Crypts (Adventure)".

GET /v2/maps

&type = Map family

&variant = Game-mode variant

&dungeon_id = Dungeon grouping id

Example: id.dungeon.cr

&locale = Resolve Text_* keys to translated strings (names, flavor, enum labels)

Default: en

&sort = `field:order` or `asc|desc` (default field per endpoint)

&cursor = Opaque cursor from the previous response's `pagination.next`; omit for the first page.

&limit = Pagination

Options: 1 - 200

Default: 50

GET/v2/maps?type=crypts&limit=5

type (query)

limit (query)

GET /v2/maps/grades

The loot-grade catalog per map + mode: each entry carries its map (crypts, goblin, …), mode (adventure / normal / high_roller / …), gear_pool, the max_rarity that can show there, and a readable name (Crypts (High Roller)). It is the definition behind each drop's map_tier.

&tier = Only grades at this difficulty tier

&limit = Pagination

Options: 1 - 200

Default: 50

GET/v2/maps/grades?limit=10

limit (query)

GET /v2/maps/{id}

&id = Pick any map id from the list

Returns the full map row including display_name, variant, the dungeon_id link, and a modules array — the dungeon-module tiles this map's type is built from (the server owns the type → module_type join, so deep zones like Inferno fold under their parent). Each carries id, name, module_type, slot footprint (size_x/size_y) and is_edge_only. has_image is false when the tile ships only the game's placeholder minimap (the Ship Graveyard set) — skip its image and show a glyph.

GET/v2/maps/{id}

id (path)