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!

Overview

Version
v2.1.2
Host
https://api.darkerdb.com

The DarkerDB API serves Dark and Darker game data as plain JSON: items, monsters, maps, quests, loot, market prices, and more. Every response is wrapped in a standard envelope:

GET/v2/health-check

Endpoint parameters are color coded to indicate if they are required, optional or global options. The global options behave the same on every endpoint.

Game data vs live data

The API serves two families that behave differently. Know which one you're reading:

Game data

The static catalog pulled from the game's design files: items, monsters, maps, quests, loot, and more. It's patch-versioned and cached, so it only changes when a new patch lands. Served under the darkerdb.data scope.

Live data

Observations captured from the running game: market listings, trades, population, and leaderboards. It updates continuously and isn't patch-time-travelable. Served under the darkerdb.live scope, throttled tighter.

Authentication

Most reads need an API key. Sign in with Discord, then mint one on the API keys dashboard. Send it in the X-API-Key header:

bash
curl https://api.darkerdb.com/v2/items \
  -H "X-API-Key: your-api-key"

Each key carries one or more scopes that gate what it can read and set its own rate limit. A few keyless routes (icons, model and map images, the health probe) stay open. See Authentication for scopes and rate limits.

Released clients should also pin an API contract. Omitting X-API-Version follows the latest response shape.

Reference

Cross-cutting behaviour that parameters refer to globally lives in the Reference section:

Parameters & Types
Value formats: ranges, booleans, timestamps, intervals, attributes, class flags.
Facets
The enum dictionary. Every filter's valid values as stable value/label lists.
Pagination
Cursor- and page-based traversal.
Localization
Resolve Text_* keys to translated strings with ?locale.
Envelope
The wrapper around every response, including the ?condense null-stripping flag.
Icon Transforms
Resize, reformat, trim, and recolor any /icon or /image URL.
Authentication
API keys, scopes, and per-scope rate limits.
API Versioning
Pin a dated response contract for released clients.
Data Retention
How long each data feed is kept.

Support

Built something with the API, hit a snag, or want an endpoint that isn't here yet? Join the discussion in our Discord.

Table of Contents