Public Suffix List (eTLD+1) lookup API

Resolve any domain to its registrable domain (eTLD+1), public suffix, and subdomain using the canonical Mozilla Public Suffix List (cached daily), with correct wildcard/exception handling and ICANN-vs-PRIVATE flags. The MORE: agents get eTLD+1 wrong constantly; this is list-backed and deterministic. Answers 'what is the registrable domain of foo.bar.co.uk', 'eTLD+1 of this hostname', 'public suffix for this domain', 'is this an ICANN or private suffix'.

Price$0.01per request

MethodPOST

Route/v1/ref/public-suffix

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache86400s public

refpslpublic-suffixetldetld+1domainregistrable-domaintld

API URLhttps://x402.hexl.dev/v1/ref/public-suffix

Integration docs

Example request

{
  "domain": "foo.bar.co.uk"
}

Example response

{
  "domain": "foo.bar.co.uk",
  "publicSuffix": "co.uk",
  "registrableDomain": "bar.co.uk",
  "subdomain": "foo",
  "isIcann": true,
  "isPrivate": false,
  "isException": false
}

Input schema

{
  "type": "object",
  "required": [
    "domain"
  ],
  "properties": {
    "domain": {
      "type": "string",
      "examples": [
        "foo.bar.co.uk"
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}