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!

Songs

Bard performance songs (Harmonic Shield, Din of Darkness, Aria of Alacrity, ...). Distinct from /v2/spells: a song's effect scales with performance timing, so its description resolves three value tiers — Bad, Good and Perfect — which the template's [0]/[1]/[2] placeholders index into. Each song inlines the abilities it grants, and each ability inlines its gameplay effects. Always reflects the current patch.

GET /v2/songs

&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/songs?limit=5

limit (query)

GET /v2/songs/{id}

&id = Pick any song id from the list

GET/v2/songs/{id}

id (path)

GET /v2/songs/{id}/icon

&id = Pick any song id from the list

&size = Icon transforms — resize to N (square) or WxH. 1–512 per axis.

Example: 64 or 64x96

&dpr = Icon transforms — pixel-density multiplier (1, 2, or 3). Combine with size for retina renders.

&format = Icon transforms — re-encode. Omit to keep the source format.

&trim = Icon transforms — auto-strip transparent margin (1% fuzz).

&bg = Icon transforms — background fill (#RRGGBB, #RRGGBBAA, or transparent).

Example: #000000 or transparent

GET/v2/songs/{id}/icon

id (path)