# Suggest alternate domain names (https://developer.godaddy.com/en/docs/references/rest/domains/v1/suggest) --- title: Suggest alternate domain names description: >- Returns domain name suggestions based on a seed domain, keywords, or purchase history. full: true --- Full description Returns domain name suggestions based on a seed domain, keywords, or purchase history. Useful for presenting alternatives when a desired domain is unavailable. ## GET /v1/domains/suggest Suggest alternate domain names Returns domain name suggestions based on a seed domain, keywords, or purchase history. Useful for presenting alternatives when a desired domain is unavailable. ### Query parameters | Name | Type | Required | Description | |------|------|----------|-------------| | `query` | string | no | Domain name or set of keywords for which alternative domain names will be suggested | | `country` | string | no | Two-letter ISO country code to be used as a hint for target region NOTE: These are sample values, there are many more | | `city` | string | no | Name of city to be used as a hint for target region | | `sources` | array | no | Sources to be queried - **CC_TLD** — Varies the TLD using Country Codes - **EXTENSION** — Varies the TLD - **KEYWORD_SPIN** — Identifies keywords and then rotates each one - **PREMIUM** — Includes variations with premium prices | | `tlds` | array | no | Top-level domains to be included in suggestions NOTE: These are sample values, there are many more | | `lengthMax` | integer | no | Maximum length of second-level domain | | `lengthMin` | integer | no | Minimum length of second-level domain | | `limit` | integer | no | Maximum number of suggestions to return | | `waitMs` | integer | no | Maximum amount of time, in milliseconds, to wait for responses If elapses, return the results compiled up to that point | ### Header parameters | Name | Type | Required | Description | |------|------|----------|-------------| | `X-Shopper-Id` | string | no | Shopper ID which owns the domain. NOTE: This is only required if you are a Reseller managing a domain purchased outside the scope of your reseller account. | ### Responses **200** — Request was successful Content-Type: `application/json` Schema: - array - items: Content-Type: `application/javascript` Schema: - array - items: Content-Type: `application/xml` Schema: - array - items: Content-Type: `text/javascript` Schema: - array - items: Content-Type: `text/xml` Schema: - array - items: **400** — Request was malformed Content-Type: `application/json` Schema: - schema reference: `#/components/schemas/Error` Content-Type: `application/javascript` Schema: - schema reference: `#/components/schemas/Error` Content-Type: `application/xml` Schema: - schema reference: `#/components/schemas/Error` Content-Type: `text/javascript` Schema: - schema reference: `#/components/schemas/Error` Content-Type: `text/xml` Schema: - schema reference: `#/components/schemas/Error` **401** — Authentication info not sent or invalid Content-Type: `application/json` Schema: - schema reference: `#/components/schemas/Error` Content-Type: `application/javascript` Schema: - schema reference: `#/components/schemas/Error` Content-Type: `application/xml` Schema: - schema reference: `#/components/schemas/Error` Content-Type: `text/javascript` Schema: - schema reference: `#/components/schemas/Error` Content-Type: `text/xml` Schema: - schema reference: `#/components/schemas/Error` **403** — Authenticated user is not allowed access Content-Type: `application/json` Schema: - schema reference: `#/components/schemas/Error` Content-Type: `application/javascript` Schema: - schema reference: `#/components/schemas/Error` Content-Type: `application/xml` Schema: - schema reference: `#/components/schemas/Error` Content-Type: `text/javascript` Schema: - schema reference: `#/components/schemas/Error` Content-Type: `text/xml` Schema: - schema reference: `#/components/schemas/Error` **404** — Resource not found Content-Type: `application/json` Schema: - schema reference: `#/components/schemas/Error` Content-Type: `application/javascript` Schema: - schema reference: `#/components/schemas/Error` Content-Type: `application/xml` Schema: - schema reference: `#/components/schemas/Error` Content-Type: `text/javascript` Schema: - schema reference: `#/components/schemas/Error` Content-Type: `text/xml` Schema: - schema reference: `#/components/schemas/Error` **422** — `query` must be specified Content-Type: `application/json` Schema: - schema reference: `#/components/schemas/Error` Content-Type: `application/javascript` Schema: - schema reference: `#/components/schemas/Error` Content-Type: `application/xml` Schema: - schema reference: `#/components/schemas/Error` Content-Type: `text/javascript` Schema: - schema reference: `#/components/schemas/Error` Content-Type: `text/xml` Schema: - schema reference: `#/components/schemas/Error` **429** — Too many requests received within interval Content-Type: `application/json` Schema: - schema reference: `#/components/schemas/ErrorLimit` Content-Type: `application/javascript` Schema: - schema reference: `#/components/schemas/ErrorLimit` Content-Type: `application/xml` Schema: - schema reference: `#/components/schemas/ErrorLimit` Content-Type: `text/javascript` Schema: - schema reference: `#/components/schemas/ErrorLimit` Content-Type: `text/xml` Schema: - schema reference: `#/components/schemas/ErrorLimit` **500** — Internal server error Content-Type: `application/json` Schema: - schema reference: `#/components/schemas/Error` Content-Type: `application/javascript` Schema: - schema reference: `#/components/schemas/Error` Content-Type: `application/xml` Schema: - schema reference: `#/components/schemas/Error` Content-Type: `text/javascript` Schema: - schema reference: `#/components/schemas/Error` Content-Type: `text/xml` Schema: - schema reference: `#/components/schemas/Error` **504** — Gateway timeout Content-Type: `application/json` Schema: - schema reference: `#/components/schemas/Error` Content-Type: `application/javascript` Schema: - schema reference: `#/components/schemas/Error` Content-Type: `application/xml` Schema: - schema reference: `#/components/schemas/Error` Content-Type: `text/javascript` Schema: - schema reference: `#/components/schemas/Error` Content-Type: `text/xml` Schema: - schema reference: `#/components/schemas/Error` **Security:** requires `bearerAuth`.