GET

Suggest Domains

Suggests domains that are available for purchase, based on the provided query input.

You may use this endpoint to get inspired and then call Check Domain Availability to check whether a specific variation of the suggestions is also available for purchsase.

The tlds must not include the dot. For example, com and not .com.

Important: This call requires an account level API key and cannot be authenticated with the standard authorization header.

Endpoint
GET
https://www.wixapis.com/domain-search/v2/suggest-domains
Query Params
querystringRequired

Input to base your domain suggestions on. May include letters, numbers, spaces, dots, and hyphens. Must not include the TLD.

Min: 3 characters Max: 100 characters

tldsArray <string>

Top-level domains. Must not include the dot. For example, com, not .com. Not all TLDs can be connected to Wix sites. Supported TLDS include com, net, and org. Contact the Wix B2B sales team for more information.

Max: 10 TLDs

limitintegerdeprecated - use limit instead

Number of domain suggestions to return. Deprecated: This field will be removed on March 1, 2025. Use paging.limit instead.

Min: 1 Max: 20 Default: 10

paging.limitintegerminimum 1maximum 20format int32

Maximum number of domains to return in the results.

Min: 0 Max: 20

paging.cursorstringminLength 0maxLength 10000

Pointer to the next or previous page in the list of results.

You can get the relevant cursor token from the pagingMetadata object in the previous call's response. Not relevant for the first request.

maxLengthinteger

Maximum number of characters for the domain name, excluding the TLD.

Min: 3 Max: 63 Default: 63

Response Object
suggestionsArray <DomainSuggestion>

List of suggested available domains.

pagingMetadataPagingMetadata

Metadata about the returned list of suggested domains.

Retrieve suggestions for available domains.
Request
cURL
curl -X GET 
'https://www.wixapis.com/domain-search/v2/suggest-domains?query=my%20stunning%20domain&paging.limit=4&tlds=com&tlds=love' \
-H 'Authorization: <AUTH>' \
Response
JSON
{
   "pagingMetadata":{
       "count": 4,
       "cursors": {
           "next": "eyJxdWVyeSI6ImZsb3dlcnMxIiwic3VnZ2VzdGlvbnMiOlsiZmxvd2VyczEub25saW5lIiwiZmxvd2VyczEuaW5mbyIsImZsb3dlcnMxLm5ldCIsImZsb3dlcnMxLmJpeiJdLCJwcmV2U3VnZ2VzdGlvbnMiOlsiZmxvd2VyczEubmV0IiwiZmxvd2VyczEuYml6Il19",
           "prev": null
       },
       "hasNext":true
   },
   "suggestions":[
      {
         "domain": "find-my-domain.com",
         "premium": false
      },
      {
         "domain": "mydomain.com",
         "premium": true
      },
      {
         "domain": "mydomain.love",
         "premium": false
      },
      {
         "domain": "my-domain.love"
         "premium": false
      }
   ]
}
Errors

This method doesn’t return any custom errors, but may return standard errors. Learn more about standard Wix errors.

Did this help?