Knowledge Base

How to Check Premium Domain Availability via the API

When your system or integration needs to check premium domain availability programmatically. This article explains how to check premium domain availability using the API.

Description

Returns a list of Aftermarket Premium domain names based on the specified keyword. This method only returns names available on the secondary market, and not those premium names that are offered directly by any Registry for new registration.

Parameters

Name	Data Type	Required / Optional	Description
auth-userid	Integer	Required	Your Live Account Reseller Id
api-key	String	Required	An alphanumeric code that can be used to authenticate your API calls
key-word	String	Required	Word or phrase (please enter the phrase without spaces) for which premium search is requested
tlds	Array of Strings	Required	Domain name extensions (TLDs) you want to search in 1
price-high	Integer	Optional	Maximum price (in Reseller's Selling Currency) upto which domain names must be suggested
price-low	Integer	Optional	Minimum price (in Reseller's Selling Currency) for which domain names must be suggested
no-of-results	Integer	Optional	Number of results to be returned

HTTP Method

GET

Example Test URL Request

https://domaincheck.httpapi.com/api/domains/premium/available.xml?
auth-userid=0&api-key=key&key-word=domain&tlds=com&tlds=net
&tlds=org&price-high=10000&no-of-results=10

Response

Returns a hash map with a list of Aftermarket Premium domain names and the price for each of them.