Features

Domain Suggestions

Discover your perfect domain name with our Domain Availability API. Get personalized suggestions and find the ideal match for your website. By default, we provide 5 domain suggestions, but by signing in and setting 'suggestion' to true, you can fetch up to 100 domain suggestions.

Bulk Domain Name Search

Check the availability of multiple domains effortlessly with our user-friendly API. Ideal for businesses, it saves time and effort by quickly checking domain availability in bulk, streamlining your domain management process.

Real-time data

Stay updated with the latest domain information through real-time data synchronization, ensuring your queries are accurate and relevant. This feature guarantees that you always have the most current domain data at your fingertips.

Supported formats

We support data retrieval in JSON and XML formats, providing flexibility and compatibility with various applications and systems. This ensures seamless data integration and processing for your needs.

Common Use Cases

Domain Registration Platforms Domain registration platforms can use the API to check the availability of multiple domains in bulk, helping customers to register the domains according to their needs.
Web Hosting Providers Web hosting providers can use our API to check domain name availability for customers, offering registration as an add-on. Our API simplifies the process, making it easy to integrate and deliver efficient results.
Digital Agencies Digital agencies can use the API to check the availability of domain names for their clients to offer them personalised domain name suggestions, making it easier for them to choose the right domain name for their brand.
Brand Protection Companies can use our API to generate domain name ideas for marketing campaigns and check their availability, streamlining the process and ensuring the perfect match for their brand.
Domain Investors Domain investors can use the API to research the availability of domain names they are interested in purchasing and make informed decisions about their domain name investments.
Marketing Campaigns Companies can use the API to generate domain name ideas for their marketing campaigns and check the availability of those domains.
Response
Domain Availability Documentation

Authorization

You can make authorized requests to our API by passing API key as a query parameter. To get your API key, login to our billing dashboard and get your API key! If your API key has been compromised, you can change it by clicking on reset button in billing dashboard.

API GET
https://api.whoisfreaks.com/v1.0/domain/availability?apiKey=API_KEY&domain=whoisfreaks.com
API GET
https://api.whoisfreaks.com/v1.0/domain/availability?apiKey=API_KEY&domain=whoisfreaks.com&sug=true
API GET
https://api.whoisfreaks.com/v1.0/domain/availability?apiKey=API_KEY&domain=whoisfreaks.com&sug=true&count=10
Query Parameters
  • Required
    apiKeyGet your API key from our billing dashboard.
    domainThe domain to check availability.
  • Optional
    sugFor getting suggestions, it can be passed with or without a count. There are two possible values for sug: true or false. If you don't specify the sug parameter, the default value will be false.
    countIf sug is true then count can be passed for desired number of suggestions. Default value of count is 5.
    formatTwo formats are available JSON, XML. If you don't specify the 'format' parameter, the default format will be JSON.
Responses
200 OK
400 Invalid domain name parameters.
401 Provided API key is invalid.
401 Provided API key is inactive.
401 Please buy a subscription plan or add api credits.
401 Your subscription is deactivated.
401 Repeated payment failures.
401 Your account is deactivated.
401 Suspicious Activity.
403 Unavailable domain extension.
403 Domain belongs to an inactive TLD.
408 Unable to fetch whois data.
412 Exceeded the limit of api plan requests.
413 Exceeded the limit of api credits requests.
413 Exceeded the limit of surcharge requests.
429 Maximum request limit reached.
500 Internal Server error.
503 Service is unavailable.
504 Request is timed-out.
Request
Shell Node.js Java Python PHP Ruby JS C# Go C Swift
GET
Copy
Response
200 400 401 403 408 412 413 429 500 503 504
Copy
OK
Response
200 400 401 403 408 412 413 429 500 503 504
With Suggestions
Copy
OK

Authorization

You can make authorized requests to our API by passing API key as a query parameter. To get your API key, login to our billing dashboard and get your API key! If your API key has been compromised, you can change it by clicking on reset button in billing dashboard.

The request body is mandatory. Click here to see an example.

API POST
https://api.whoisfreaks.com/v1.0/domain/availability?apiKey=API_KEY
Body | raw
{
    "domainNames":[
        "jfreaks.pk",
        "whoisfreaks.com"
    ]
}
Copy

Bulk domain availability with custom TLDs

API POST
https://api.whoisfreaks.com/v1.0/domain/availability?apiKey=API_KEY&domain=whoisfreaks.com
Body | raw
{
    "tld":[
        "com",
        "pk"
    ]
}
Copy
Query Parameters
  • Required
    apiKeyGet your API key from our billing dashboard.
  • Optional
    formatTwo formats are available JSON, XML. If you don't specify the 'format' parameter, the default format will be JSON.
Request Body
    In the request body, add either domainNames or, for bulk availability with custom TLDs, add tld(s). Click here to see an example.
Responses
200 OK
206 Partial response.
400 Please provide domainNames.
401 Provided API key is invalid.
401 Provided API key is inactive.
401 Please buy a subscription plan or add api credits.
401 Your subscription is deactivated.
401 Repeated payment failures.
401 Your account is deactivated.
401 Suspicious Activity.
403 Unavailable domain extension.
403 Domain belongs to an inactive TLD.
412 Exceeded the limit of api plan requests.
413 Exceeded maximum list size of 100.
413 Exceeded the limit of surcharge requests.
429 Maximum request limit reached.
500 Internal Server error.
503 Service is unavailable.
504 Request is timed-out.
Request
Shell Node.js Java Python PHP Ruby JS C# Go C Swift
POST
Copy
Response
200 206 400 401 403 412 413 429 500 503 504
Copy
OK
Response
200 206 400 401 403 412 413 429 500 503 504
With Custom TLDs
Copy
OK

Credit Usage API

You need credits to use the domain availability API. Below is the credit usage for each lookup API.

  • Single domain availability query will be charged 1 credit without suggestions. If you enable suggestions, you will be charged 1 credit for every 5 suggestions.
  • 1 credit will be charged for each domain that is returned in bulk operation.

You can fetch credits usage and remaining credits information through this API.

Request
GET
Copy
Response
XML JSON
Copy



FAQs

What is Domain Availability API?

Our Domain Availability API checks if a domain is available for registration or not. It also suggests other domains and their availability for registration.

What is the criteria for Domain Suggestions?

Domains are suggested based on a GTLDs that are more popular in terms of higher number of domains registered with that particular TLD.

What is Bulk Domain Availability API?

Bulk Domain Availability API allows you to check domain availability of multiple domains in a single request. A maximum of 100 domains can be sent in a single request. Moreover, it generates suggestions based on custom TLDs.

What is the response time for Bulk Domain Availability API?

Bulk Domain Availability API response takes from 16 seconds to 1 minute for 100 domains.

What is the number of free API credits available for new users, and are these credits rate-limited?

We will provide 500 API credits to new users and yes, those credits have a rate-limiting of 10 requests per minute for Live APIs, 5 requests per minute for Bulk Domain Lookup, and 1 request per minute for Reverse/Historical Endpoints.

Do you have rate limiting on the number of requests being made on your paid plans?

Yes, we have rate limiting on requests being made on all of our paid plans. The requests limit is shown in the following table.

The Table is divided into three types of plans:

1) API Credits

Credits Live-rpm Bulk-rpm Historical/Reverse-rpm
5000 20 8 3
15000 35 12 5
50000 80 20 10
150000 120 25 15
450000 150 35 20
1000000 200 50 25
3000000 300 70 35

2) API Subscription

Credits Live-rpm Bulk-rpm Historical/Reverse-rpm
5000 20 8 3
15000 35 12 5
50000 80 20 10
150000 120 25 15
450000 150 35 20
1000000 200 50 25
3000000 300 70 35
  • Live-rpm: API requests per minute limit for live Whois lookup API, domain availability API, SSL certificate lookup API, and DNS lookup API endpoints.
  • Bulk-rpm: API requests per minute limit for bulk domain Whois lookup API endpoint.
  • Historical/Reverse-rpm: API requests per minute limit for historical, and reverse Whois API endpoints.

In case, the request per minute exceeds, it'll throw an error with HTTP error code of 429.

Do you provide any headers in API response regarding rate limiting?

Yes, there are following three header parameters in the response:

  • X-RateLimit-Allowed-Requests: Tells the max allowed API requests per minute on a specific plan.
  • X-RateLimit-Remaining-Requests: Tells the remaining API requests per minute for that plan.
  • X-RateLimit-Remaining-Time: Tells after how much time the API requests per minute will be reset.
Whois footer banner