Agent-ready discovery

NextName Public API

This page documents the public APIs that NextName currently exposes for domain research workflows. It is the canonical human-readable service documentation target for the site's agent discovery metadata.

Discovery boundary

GET

/api/domain/[domain]

Returns a normalized domain availability and WHOIS summary for one domain name.

Parameters

  • `[domain]` path segment is required and should be a fully-qualified domain.

Response

  • `domain`
  • `is_available`
  • `query_method`
  • `status`
  • `name_servers`
  • `error_code` on controlled failures

Cache notes: Results are cached in-process to reduce duplicate upstream lookups.

Example request: /api/domain/example.com

GET

/api/whois/[domain]

Returns raw WHOIS text or controlled runtime failure details for one domain.

Parameters

  • `[domain]` path segment is required and should be a fully-qualified domain.

Response

  • `domain`
  • `raw_whois`
  • `query_method`
  • `transport`
  • `runtime_support_policy`
  • `error_code` when unavailable

Cache notes: This endpoint prefers the unified runtime query chain and falls back to third-party raw WHOIS when needed.

Example request: /api/whois/example.com

GET

/api/dns/[domain]

Fetches common DNS record families for a domain through Google Public DNS.

Parameters

  • `[domain]` path segment is required and should be a fully-qualified domain.

Response

  • `domain`
  • `provider`
  • `fetchedAt`
  • `records`
  • `error` on upstream failure

Cache notes: Successful responses are cached in memory without KV persistence.

Example request: /api/dns/example.com

GET

/api/ssl/[domain]

Returns the latest discovered certificate summary for a domain using crt.sh with a secondary fallback.

Parameters

  • `[domain]` path segment is required and should be a fully-qualified domain.

Response

  • `domain`
  • `provider`
  • `status`
  • `certificate`
  • `totalCertificates`
  • `error` on upstream failure

Cache notes: Successful responses are cached in memory without KV persistence.

Example request: /api/ssl/example.com

GET

/api/pricing

Returns current registrar pricing data used by TLD pricing surfaces.

Parameters

  • Query parameters depend on the requested pricing slice.
  • This endpoint is intended for the same public pricing data visible in the site UI.

Response

  • Pricing payload fields vary by query, but stay within the public registrar and TLD pricing domain.

Cache notes: Pricing responses are cached at the edge through shared API cache headers.

Example request: /api/pricing?tld=.com

GET

/api/tlds

Returns the public TLD data used by the TLD listing and search experiences.

Parameters

  • No required parameters.

Response

  • TLD listing data used by public browsing and search features.

Cache notes: TLD data is stable and can be cached more aggressively than live lookup endpoints.

Example request: /api/tlds

GET

/api/tld-list

Returns the public list of TLDs used by query and suggestion flows.

Parameters

  • No required parameters.

Response

  • TLD collection payload used by public query surfaces.

Cache notes: TLD list data is stable and suitable for edge caching.

Example request: /api/tld-list