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 API | Stats API | |
|---|---|---|
| What it returns | A full appraisal of a domain name: price band, verdict, the AI signals | Domain industry statistics: TLDs, registry operators and registrars month by month, launch phases, nightly zone counts |
| Access | An API key, from Settings → API keys | None. No key, no account |
| Cost | Credits from your wallet, 10 per full read | Free |
| URL | https://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
Code
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