Public API

Quick start

curl 'https://www.dndnamebook.com/api/names?race=tabaxi&count=5'

const res = await fetch(
  'https://www.dndnamebook.com/api/names?race=dragonborn&gender=female&count=10'
);
const data = await res.json();
data.names.forEach(n => console.log(n.full));

Endpoint

Query parameters

Rate limits

Rate limits are per IP, sliding window. No authentication or API key required. Designed to be generous for any honest use, tight enough to stop runaway scrapers.

When exceeded, the API returns HTTP 429 with these response headers: Retry-After (seconds), X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (ms epoch), X-RateLimit-Tier (burst or daily). The JSON body includes retryAfterSeconds for convenience. Need more? Email us — happy to whitelist legitimate high-volume use.

Response shape

{
  "race": "dragonborn",
  "raceDisplayName": "Dragonborn",
  "count": 5,
  "gender": "any",
  "includeSurname": true,
  "surnameLabel": "Clan",
  "names": [
    { "given": "Akvash", "surname": "Emberforge", "full": "Akvash Emberforge" },
    { "given": "Yssira", "surname": "Stormcoil", "full": "Yssira Stormcoil" }
  ],
  "attribution": {
    "source": "https://www.dndnamebook.com",
    "license": "CC0 — names produced by this API are free for any use."
  }
}

Errors return HTTP 4xx with { error: { code, message } }. Error codes: missing_race, invalid_race, invalid_count, invalid_gender, invalid_startsWith, rate_limit_exceeded (HTTP 429 — see Rate limits).

Built for AI agents

Whether you're building an LLM-powered DM assistant, a Discord bot, a Foundry VTT module, or a Cursor / Claude Code workflow, this site is engineered to be usable without a browser. Concrete provisions:

• llms.txtPlain-Markdown site description at /llms.txt — every race, every URL, every API parameter, every paragraph of lore. Drop it into your agent's context once and it knows the whole site.
• Schema.org structured dataEach generator page emits WebApplication + BreadcrumbList + FAQPage JSON-LD in a single @graph.
• Stable selectorsEvery interactive element carries a data-testid (e.g. generate-button, name-result). Each generated name carries data-name, data-given, data-surname, and data-race attributes for direct extraction.
• ARIA-clean DOMrole="radiogroup", aria-checked, aria-live="polite" on results, descriptive aria-label on every control. The accessibility tree maps cleanly to agent perception.
• Server-rendered contentAll race lore, naming conventions, and tool UI are in the initial HTML. No JS-only views. Works for crawlers and headless fetches.
• No anti-bot patternsNo cookie banners gating content. No CAPTCHAs. No login walls. No hover-only interactions. No client-side rendering blockers.

Licensing & attribution

Names returned by the API are CC0 — you may use them in any project, commercial or otherwise, without attribution. Attribution to dndnamebook.com is appreciated but not required. Race lore prose on individual generator pages is © DND Name Book and may not be reproduced verbatim.