API docs

Programmatic access to ranked drops and domain dossiers. Available on Pro ($19/mo, 100 req/day) and API ($49/mo, 10k req/day) tiers.

Authentication

Generate an API key on your /account page. Send it in the Authorization header:

curl https://namenotifier.com/api/v1/drops \ -H "Authorization: Bearer nn_xxxxxxxxxx"

GET /api/v1/drops

Returns today’s ranked drop list.

Query parameters

Param	Example	Meaning
tld	com,io	CSV of TLDs to filter
min_dqs	70	Minimum Domain Quality Score 0-100
max_len	8	Maximum SLD character length
q	ai	Substring match on domain name
limit	100	Max rows returned (default 100, max 1000)

Response

{
  "date": "2026-04-14",
  "count": 50,
  "availableTlds": ["com","io","org"],
  "drops": [
    {
      "name": "aitools.io",
      "tld": "io",
      "length": 7,
      "dqs": 74,
      "explanation": "genuinely brandable and commercial ai intent, plus compact",
      "signals": { ... }
    }
  ]
}

GET /api/v1/domain/{name}

Full dossier for a single domain including feedback totals.

{
  "domain": "aitools.io",
  "tld": "io",
  "length": 7,
  "currentStatus": "available",
  "latestDrop": {
    "date": "2026-04-14",
    "dqs": 74,
    "explanation": "...",
    "signals": { ... }
  },
  "feedback": { "up": 12, "down": 1 }
}

Rate limits

Free: no API access. Pro: 100 requests/day. API tier: 10,000 requests/day. Rate limit is enforced per API key. Limits reset at 00:00 UTC.

Errors

All errors return JSON with an error field and appropriate HTTP status.