# Suggest available domains for a query (https://developer.godaddy.com/en/docs/references/rest/domains/v3/suggest-domains)

---
title: Suggest available domains for a query
description: >-
  Returns available domain name suggestions for a natural-language query or
  keyword set.
full: true
---

Full description

\| Returns available domain name suggestions for a natural-language query or keyword set. All results are available (available-only contract). Prices are indicative; the authoritative price and availability check is at quote time.

## GET /suggestions

Suggest available domains for a query

Returns available domain name suggestions for a natural-language query
or keyword set. All results are available (available-only contract).
Prices are indicative; the authoritative price and availability check
is at quote time.


### Query parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `query` | string | no | Natural-language query or keywords describing the desired domain, e.g. "sunrise bakery". Used to generate creative and keyword-spin suggestions. |
| `tlds` | array | no | Top-level domains to be included in suggestions. |
| `lengthMax` | integer | no | Maximum length of second-level domain. |
| `lengthMin` | integer | no | Minimum length of second-level domain. |
| `pageSize` | integer | no | Maximum number of suggestions in the response. Defaults to 10 when omitted. |
| `sources` | array | no | Suggestion source strategies to activate. |

### Header parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `X-Request-Id` | unknown | no | Optional client-generated request correlation identifier, propagated across services and returned in the response X-Request-Id header. |

### Responses

**200** — Suggested available domains sorted by relevance.

Content-Type: `application/json`

```json
{
  "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
          },
          "recommended": true
        }
      ]
    },
    {
      "domain": "sunrisebakery.shop",
      "inventory": "REGISTRY",
      "prices": [
        {
          "term": "YEAR",
          "period": 1,
          "price": {
            "currencyCode": "USD",
            "value": 299
          },
          "renewalPrice": {
            "currencyCode": "USD",
            "value": 599
          }
        },
        {
          "term": "YEAR",
          "period": 2,
          "price": {
            "currencyCode": "USD",
            "value": 798
          },
          "renewalPrice": {
            "currencyCode": "USD",
            "value": 1198
          },
          "firstTermPrice": {
            "currencyCode": "USD",
            "value": 199
          },
          "recommended": true
        }
      ]
    }
  ]
}
```

Schema:

- object
  - `items` (required): array — Available domain suggestions, sorted by relevance. All items are available by contract.
      - items:

**400** — Malformed request syntax, missing required field, or invalid field type.

Content-Type: `application/json`

Schema:

- schema reference: `#/x-ext/21ae8c5`

**401** — Authentication credentials are missing or invalid.

Content-Type: `application/json`

Schema:

- schema reference: `#/x-ext/21ae8c5`

**403** — Authenticated identity is not authorized to perform this operation.

Content-Type: `application/json`

Schema:

- schema reference: `#/x-ext/21ae8c5`

**429** — Too many requests — rate limit exceeded.

Content-Type: `application/json`

Schema:

- schema reference: `#/x-ext/21ae8c5`

**Security:** requires `bearerAuth`.