API Documentation

Programmatic access to ground-truth domain availability. Pro and Agency plans include API access.

Authentication

Include your API key in the x-api-key header:

curl -H "x-api-key: dfk_live_..." \
  "https://your-domain.com/api/search?q=findmydomain"

Endpoints

GET/api/search

Search for available domains across 500+ TLDs.

Query parameters:

q — base name to search (required, 1-63 chars, alphanumeric + hyphens)
max_price — max price filter in USD (optional, default 50)

Response:

{
  "query": "findmydomain",
    "results": [
    { "domain": "findmydomain.nexus", "price_usd": 17.99, "source": "rdap" },
    { "domain": "findmydomain.africa", "price_usd": 14.99, "source": "rdap" }
  ],
  "duration_ms": 2453,
  "cached": false,
  "api_calls_remaining": 997
}

Rate Limits

Plan	Lookups/month	Rate limit
Free	5/day	3 results per search
Pro	1,000	30 req/min
Agency	10,000	60 req/min

Errors

400Missing or invalid query parameter

429Rate limit exceeded — subscribe for more

500Search failed (RDAP unavailable, timeout)

Ready to build with ground-truth domain data?

View pricing →