Namedesk
Guides

Namedesk API

Two APIs on one host, https://api.namedesk.app. Every path in these docs is on that host, not on namedesk.app (a /v1/... path requested on namedesk.app redirects there).

Appraisal APIStats API
What it returnsA full appraisal of a domain name: price band, verdict, the AI signalsDomain industry statistics: TLDs, registry operators and registrars month by month, launch phases, nightly zone counts
AccessAn API key, from Settings → API keysNone. No key, no account
CostCredits from your wallet, 10 per full readFree
URLhttps://api.namedesk.app/v1/research-jobs, https://api.namedesk.app/v1/report/{domain}https://api.namedesk.app/v1/stats/...

Both return JSON, use the same error shape, and are described in one OpenAPI document.

Working in Claude, Cursor or another AI assistant? Skip the HTTP calls: the Namedesk MCP server gives it the main statistics and appraisal calls as tools. The statistics tools are free and need no key.

First call

TerminalCode
# Stats: no key curl https://api.namedesk.app/v1/stats/tlds/xyz # Appraisal: with a key curl -X POST https://api.namedesk.app/v1/research-jobs \ -H "x-api-key: $ND_KEY" \ -H "content-type: application/json" \ -d '{"domains": ["stripe.com"]}'

Keys

Create a key in Settings → API keys. The full key is shown once. Send it as x-api-key or as Authorization: Bearer. A key belongs to your team and keeps working when the person who made it leaves.

On the Stats API a key is optional. Sending one raises the request limit; it never costs credits.

Last modified on