curl --request POST \
  --url https://api.dev.name.com/core/v1/domains:search \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "keyword": "mydomain",
  "timeout": 2500,
  "tldFilter": [
    "com",
    "net",
    "org"
  ]
}
'

{
  "results": [
    {
      "domainName": "example.com",
      "purchasable": true,
      "sld": "example",
      "tld": "com",
      "premium": true,
      "purchasePrice": 10.99,
      "renewalPrice": 10.99,
      "reason": "<string>"
    }
  ]
}

Domains

Search

Searches for domain name suggestions based on a keyword or term. Important: Do not encode the : in the path. Use /core/v1/domains:search, not /core/v1/domains%3Asearch.

Discovery endpoint: Returns SearchResult fields — purchaseType, purchasePrice, premium, purchasable.

Recommendation: Set purchaseType to registration. Most resellers restrict results to domains with a purchaseType of registration to ensure predictable pricing and immediate fulfillment. Other purchase types (such as aftermarket) can introduce higher costs and non-instant transactions that may be delayed or declined by third parties. With purchaseType: registration, domains that do not match the filter are omitted from results (unlike Check Availability, which returns them with purchasable: false).

When results show premium: true or a non-registration purchaseType, follow the Domain pricing guide before calling Create Domain. For all types, re-check with Check Availability immediately before create — prices and availability can change.

POST

core

domains:search

curl --request POST \
  --url https://api.dev.name.com/core/v1/domains:search \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "keyword": "mydomain",
  "timeout": 2500,
  "tldFilter": [
    "com",
    "net",
    "org"
  ]
}
'

{
  "results": [
    {
      "domainName": "example.com",
      "purchasable": true,
      "sld": "example",
      "tld": "com",
      "premium": true,
      "purchasePrice": 10.99,
      "renewalPrice": 10.99,
      "reason": "<string>"
    }
  ]
}

Authorizations

Authorization

string

header

required

Authenticate via HTTP Basic with your account username and API token. Examples use an explicit 'Authorization: Basic <base64(username:token)>' header; 'curl -u username:token' is equivalent. For sandbox, append "-test" to your username and use your sandbox token on api.dev.name.com.

Body

application/json

SearchRequest is used to specify the search parameters.

keyword

string

required

Keyword is the search term to search for. It can be just a word, or a whole domain name.

Example:

"mydomain"

timeout

integer<int32>

Timeout is a value in milliseconds on how long to perform the search for. Valid timeouts are between 500ms to 12,000ms. If not specified, timeout defaults to 12,000ms. Since some additional processing is performed on the results, a response may take longer then the timeout.

Example:

2500

tldFilter

string[]

TLDFilter will limit results to only contain the specified TLDs. There is a maximum of 50 TLDs that can be used in this filter

Maximum array length: 50

Example:

["com", "net", "org"]

purchaseType

enum<string>

Optional. Limits results to the given purchaseType. Recommended: registration for most integrations — omit only if you choose to support acquisition types. See the Domain purchase pricing guide.

Available options:

registration,

aftermarket_i,

expiring,

backorder,

aftermarket_s,

aftermarket_b

Response

A successful response.

SearchResponse returns a list of search results.

results

object[]

Results of the search are returned here, the order should not be relied upon.

Show child attributes

Check Availability Zone Check

⌘I