Knowledge Base

Searching for Domains by any Part of the Domain Name

One of the newest functions in the Constellix API is the ability to search for domains by specifying any part of the domain name. There are four types of searches that can be done: 'startswith', 'endswith', 'contains', and 'exact'. You can search for a minimum of 3 characters or a maximum of 240 for each search type. All four of these would fall under the category of GET calls. In this tutorial, we will be using Postman to make the API calls. If you are not familiar with Postman or need guidance to get your workspace set up, click here for our Getting Started with Postman tutorial.

In the account used in this tutorial, there are three domains that will be searched for:

thisisanexample.com

thisisanotherdomain.com

thisisanotherdomain.me

Search Domains Using 'startswith'

The base URL for this call is:

https://api.dns.constellix.com/v1/domains/search?startswith=

Enter the URL into Postman's address bar and immediately after the = in the URL, enter the first 3+ characters of the domain(s) you are searching for. 

Because I searched for domains starting with "this", all three domains are returned.

Search Domains Using 'endswith'

The base URL for this call is:

https://api.dns.constellix.com/v1/domains/search?endswith=

Enter the URL into Postman's address bar and immediately after the = in the URL, enter the last 3+ characters of the domain(s) you are searching for. 

Because I searched for domains ending with ".com", only thisisanexample.com and thisisanotherdomain.com were returned.

Search Domains Using 'contains'

The base URL for this call is:

https://api.dns.constellix.com/v1/domains/search?contains=

Enter the URL into Postman's address bar and immediately after the = in the URL, enter 3+ consecutive characters that can be found in the domain(s) you are searching for. 

Because I searched for domains containing "another", only thisisanotherdomain.com and thisisanotherdomain.me were returned. 

Search Domains Using 'exact'

The base URL for this call is:

https://api.dns.constellix.com/v1/domains/search?exact=

Enter the URL into Postman's address bar and immediately after the = in the URL, enter the full domain name you are searching for.

Provided that I typed the domain name correctly, the name and domain ID will be returned.

Common Errors

If your search contained more than 240 or less than 3 characters, you will see the following error:

If you mistyped your search or search for a domain that is not in your account or that you do not have access to, you will receive a 404 not found error: