Skip to main content
GET
/
api
/
v1
/
domains
/
suggestions
Get domain name suggestions
curl --request GET \
  --url https://dev.namify.host/api/v1/domains/suggestions \
  --header 'Authorization: Bearer <token>'
{
  "results": [
    {
      "product_category": "domain_registration",
      "domain_name": "myshopnow.com",
      "sld": "myshopnow",
      "tld": "com",
      "available": true,
      "premium": false
    },
    {
      "product_category": "domain_registration",
      "domain_name": "myshophub.com",
      "sld": "myshophub",
      "tld": "com",
      "available": true,
      "premium": false
    }
  ]
}

Authorizations

​
Authorization
string
header
required

A personal access token. Obtain one from the dashboard under Settings > API Key. Include it in the Authorization header as Bearer <token>. Unauthenticated requests to protected routes return 401 Unauthorized.

Query Parameters

​
search_term
string
required

Keyword to base suggestions on (SLD only, no dots). Must be 1–63 alphanumeric characters or hyphens; cannot start or end with a hyphen.

Example:

"myshop"

​
tld

TLD extension(s) to scope suggestions to (without leading dot). Filtered against your partner's allowed TLD list. If omitted or unrecognised, defaults to your first allowed TLD.

Example:

"com"

Response

List of suggested domain names with their availability status.

​
results
object[]