Namedesk
Guides

Namedesk API

Two APIs on one host, https://api.namedesk.app.

Appraisal APIStats API
What it returnsA full appraisal of a domain name: price band, verdict, the AI signals, the comparable salesDomain 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
Path/v1/research-jobs, /v1/report/{domain}/v1/stats/...

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

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 organisation 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