Search Domains

The Partner API v2 (Legacy) offers an endpoint that provides free and paid domain suggestions available for purchase based on the entered information. Partners can use this endpoint to implement a domain suggestions field in their application to shows users alternative domains they can purchase if what they want isn't available.

Step 1: Retrieve Your Reseller ID and Secret API Token

To access your ResellerID and Secret API Token, you must navigate to your Sandbox or Production Partner dashboard. The ResellerID is used to identify the requests as coming from a Partner, while the Secret API Token is used for authentication to ensure that only authorized Partners can access the API.

Step 2: Prepare Query Parameters

The Partner API suggestions endpoints accepts the search and tlds fields as query parameters to build domain name suggestions:

Step 3: Prepare Authorization Headers

The Partner API uses bearer tokens to authorize requests with the Secret API Token from your Partner credentials.

Step 4: Use the Get Domains Suggestions Endpoint

The Partner API has two endpoints for generating domain name suggestions: one for paid domains and another for free domains.

Send a GET request with the authorization headers and query parameters you have prepared to the Get Domains Suggestions or Get Free Domains Suggestions endpoint. Here is the URL for our API environments:

Get Domains Suggestions

Sandbox Environment:

https://api.ud-sandbox.com/api/v2/resellers/{PARTNER_RESELLERID}/domains/suggestions?search={KEYWORD}&tlds={TLD_TO_FILTER}

Production Environment:

https://unstoppabledomains.com/api/v2/resellers/{PARTNER_RESELLERID}/domains/suggestions?search={KEYWORD}&tlds={TLD_TO_FILTER}

Get Free Domains Suggestions

Sandbox Environment:

https://api.ud-sandbox.com/api/v2/resellers/{PARTNER_RESELLERID}/domains/suggestions/free?search={KEYWORD}&tlds={TLD_TO_FILTER}

Production Environment:

https://unstoppabledomains.com/api/v2/resellers/{PARTNER_RESELLERID}/domains/suggestions/free?search={KEYWORD}&tlds={TLD_TO_FILTER}

Example

Here is an example request to generate paid domain suggestions with the following parameters:

curl --location --request GET 'https://api.ud-sandbox.com/api/v2/resellers/{PARTNER_RESELLERID}/domains/suggestions?search=buyadomain.dao&search=hosting&search=doctor&tlds=dao&tlds=wallet' \
--header 'Authorization: Bearer {SECRET_API_TOKEN}'

[
  {
    "name": "buyadomain.dao",
    "price": 20
  },
  {
    "name": "buyadomainag.wallet",
    "price": 20
  },
  {
    "name": "prhosting.dao",
    "price": 20
  },
  {
    "name": "hostingdb.dao",
    "price": 20
  },
  {
    "name": "brdoctor.wallet",
    "price": 20
  }
]