Email Domains

Autocomplete email domains by prefix from the offline MX-verified list. Returns popular domains such as gmail.com and btinternet.com. Confidence is always low: the list is a ranked extract, not proof that no other domain exists, so a typed typo is not auto-selected.

Try it

—

Endpoint

GET/v1/email-domain/<query>

Base URL: https://autocomplete.namedone.com

SDK Usage

emailDomains()

1import { createClient } from "@namedone/autocomplete"
2
3const nd = createClient("nd_...")
4const { results } = await nd.emailDomains("")

curl

1# Exchange your API key for a token
2curl -X POST https://token.namedone.com/v1 \
3  -H "Content-Type: application/json" \
4  -d '{"apiKey":"nd_..."}'
5
6# Query the email domains endpoint
7curl "https://autocomplete.namedone.com/v1/email-domain/?token=<jwt>"

Response Format

JSON

{
  "results": [
    {
      "id": "email-domain-0",
      "text": "gmail.com",
    }
  ],
  "query": "",
  "confidence": "low"
}

API Query Parameters

Sent as query string parameters on the HTTP request to the API.

Parameter	Type	Default	Description
token	string	—	JWT obtained from the token API. Required for authentication.

SDK Options

Passed to the SDK methods (e.g. firstNames(query, opts)). These are processed client-side and never sent to the API.

Option	Type	Default	Description
limit	number	10	Maximum number of results (1–50). Applied client-side by the SDK.
simple	boolean	false	Simplify response: deduplicate by text and strip to {text, type}.

Examples

Query:

{
  "results": [
    {
      "id": "email-domain-0",
      "text": "gmail.com"
    },
    {
      "id": "email-domain-1",
      "text": "hotmail.com"
    },
    {
      "id": "email-domain-2",
      "text": "outlook.com"
    },
    {
      "id": "email-domain-3",
      "text": "yahoo.com"
    },
    {
      "id": "email-domain-4",
      "text": "btinternet.com"
    }
  ],
  "query": "",
  "confidence": "low"
}

Query: gm

{
  "results": [
    {
      "id": "email-domain-0",
      "text": "gmail.com"
    },
    {
      "id": "email-domain-1",
      "text": "gmx.com"
    },
    {
      "id": "email-domain-2",
      "text": "gmx.co.uk"
    }
  ],
  "query": "gm",
  "confidence": "low"
}

Notes

One request per query, the same usage count as a first-name lookup.
An empty query returns the overall top domains, served from the edge cache.
Results come from the offline MX-verified list. The API does not do a live DNS lookup.
For a whole address such as jane@gmail.com, use emailAddresses(). That method calls this endpoint.