Sign in

v1

latestOpenAPI 3.1.02026-07-2671111437.2 KB
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/v1/domains:search

Request body

keywordstring required

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

timeoutinteger

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.

tldFilterstring[]

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

purchaseType'registration' | 'aftermarket_i' | 'expiring' | 'backorder' | 'aftermarket_s' | 'aftermarket_b'

Purchase Type indicates what kind of purchase a discovery result represents. Returned by Search and Check Availability — not Zone Check.

Copy the value to Create Domain as purchaseType.

Recommendation: Pass registration on Search and Check Availability unless you choose to support acquisition inventory. Other values are supported but add integration complexity.

Pricing by type:

  • registration — Standard or registry premium. Check the premium flag: when false, omit purchasePrice on create (Get Pricing with matching years is optional for preview only); when true, purchasePrice is required from Get Pricing with matching years. years controls price and registration length.
  • aftermarket_s, aftermarket_b, aftermarket_i — Flat acquisition fee from Search or Check Availability; purchasePrice required. years does not multiply price or guarantee registration length — omit or pass TLD default.
  • expiring, backorder — Flat acquisition fee from Search or Check Availability; purchasePrice required. Get Pricing does not return these prices. years does not multiply price or guarantee registration length — omit or pass TLD default. Renew after acquisition to extend registration.

See the Domain pricing guide.

Example request

{
  "keyword": "mydomain",
  "timeout": 2500,
  "tldFilter": [
    "com",
    "net",
    "org"
  ]
}

Response

A successful response.

Example response

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