How to search domain availability

Overview

Search operations let you check whether a specific domain is available for registration, and discover alternative names based on keywords or natural-language queries. Both operations are read-only, require no payment method, and return indicative pricing alongside results.

v3 (recommended)

v3 offers two discovery operations: a single-domain availability check and a suggestions endpoint that returns available alternatives for a natural-language query.

Check availability

GET /v3/domains/check-availability?domain={domain} returns availability and per-term pricing for a single domain.

The following procedure checks whether a domain is available to register.

• Run the following command for your preferred language:

curl -s "https://api.godaddy.com/v3/domains/check-availability?domain=your-idea.com" \
  -H "Authorization: Bearer $GODADDY_PAT"

Response includes availability and indicative per-term pricing:

{
  "domain": "your-idea.com",
  "available": true,
  "definitive": false,
  "inventory": "REGISTRY",
  "prices": [
    { "term": "YEAR", "period": 1, "price": { "currencyCode": "USD", "value": 1199 }, "renewalPrice": { "currencyCode": "USD", "value": 2299 } },
    { "term": "YEAR", "period": 2, "price": { "currencyCode": "USD", "value": 3098 }, "renewalPrice": { "currencyCode": "USD", "value": 4598 }, "firstTermPrice": { "currencyCode": "USD", "value": 799 } }
  ]
}

prices[] contains one entry per available registration term. All price values are in cents.

Reference: GET /v3/domains/check-availability

Get suggestions

GET /v3/domains/suggestions returns available domain name suggestions for a natural-language query or keyword set. All results are available without filtering required.

The following procedure gets domain name suggestions for a query.

• Run the following command for your preferred language:

curl -s "https://api.godaddy.com/v3/domains/suggestions?query=sunrise+bakery&tlds=com,net,shop&pageSize=10" \
  -H "Authorization: Bearer $GODADDY_PAT"

Response is an object with an items array. Each entry includes the domain name and indicative per-term pricing:

{
  "items": [
    {
      "domain": "sunrisebakery.com",
      "inventory": "REGISTRY",
      "prices": [
        { "term": "YEAR", "period": 1, "price": { "currencyCode": "USD", "value": 1199 }, "renewalPrice": { "currencyCode": "USD", "value": 2299 } },
        { "term": "YEAR", "period": 2, "price": { "currencyCode": "USD", "value": 3098 }, "renewalPrice": { "currencyCode": "USD", "value": 4598 }, "firstTermPrice": { "currencyCode": "USD", "value": 799 } }
      ]
    }
  ]
}

price.value and renewalPrice.value are in cents — divide by 100 for the display price.

Reference: GET /v3/domains/suggestions

Use the CLI

After you set up the CLI, you can use it to check single-domain availability and get domain suggestions. See the CLI reference for the full gddy domain command list.

The following procedure checks availability and gets suggestions using the CLI.

• Run the command for your operation:

gddy domain available your-idea.com
gddy domain available your-idea.com --check-type full
gddy domain suggest "your idea" --tlds com --tlds app --limit 10

Read the response

All price objects use {currencyCode, value} where value is an integer in cents — divide by 100 for the display price. For example, {"currencyCode": "USD", "value": 1199} displays as $11.99.

Each entry in prices[] is a registration term with these fields:

Common errors

Additional information

Last updated on