Revolutionize Your Domain Search with WhoisFreaks Domain Availability API

Instantly check and verify domain availability to secure the perfect name for your brand or business.

curl --location --request GET 'https://api.whoisfreaks.com/v1.0/domain/availability?domain=whoisfreaks.com&apiKey=API_KEY&sug=true&count=10'
[
  {
    "domain": "whoisfreaks.com",
    "domainAvailability": false
  }
]
google.com
apple.com
stripe.com
apifreaks.com
pricing backgroundEclipse Top RightEclipse Top LeftEclipse WHOIS Stats

Our Products

Domain Availability APIs

Easily discover, monitor, and manage domain availability to maintain a competitive edge using our APIs.
Domain Availability Lookup
Domain Discovery Lookup
Domain Availability Lookup API

Use the Domain Availability Lookup API to instantly check domain availability across a wide range of TLDs. Customize the number of suggestions upto 100 to find the best options quickly and efficiently.

Product

Bulk Domain Availability Lookup

Enable you to retrieve deep domain intelligence instantly with a single query.

Bulk Domain Availability API

Use the Bulk Domain Availability Lookup API to check up to 100 domains across multiple TLDs, including custom TLD lists, in a single request. Quickly identify available names and apply custom result limits.

Bulk Domain Discovery API

Bulk Domain Discover API lets you submit up to 100 keywords per request and returns registered domains that contain each exact keyword. It searches across 800M+ domains spanning 1500+ TLDs and 9000+ SLDs for high-coverage results at scale.

Bulk Domain Availability API

Features

What our Domain Availability APIs Provide

High-Precision Domain Availability Checks in Bulk Across Thousands of TLDs.

Feature icon

Real Time Data

Delivers real-time domain availability results using live signals. Ideal for registrar integrations.

Feature icon

Domain Suggestions

Domain suggestions helps to generate up to 100 relevant domain ideas per request, based on the user’s input.

Feature icon

Bulk Domain Name Search

Check availability for up to 100 domains per request to accelerate validation and during bulk registrations.

Feature icon

Supported Formats

Get responses in JSON or XML format, for flexible data integrations in modern and legacy systems.

Feature icon

Domain Label Search

Easily check domain availability using keyword search with the Domain Taken API to find your perfect domain.

Feature icon

Advance Search & Filters

Use the Domain Taken API to search domains by label patterns and filter results by maximum label length for brand protection.

Feature icon

Database-Powered Search

Perform a reverse WHOIS search to find domain ownership details linked to a specific company for threat mitigation.

Feature icon

Multi-Source Domain Check

Use a domain availability API powered by multiple trusted sources like WHOIS and DNS for availability checks.

Use Cases

Domain Availability in Action

Discover who uses the Domain Availability API and how they leverage it in their work to improve conversions.

Feature icon

Domain Registration Platforms

Platforms can bulk-check domain availability, enabling faster customer registrations to hit there targets.

Feature icon

Web Hosting Providers

Web hosting providers uses our API to check domain availability and enable seamless registration, so they can act fast.

Feature icon

Digital Agencies

Digital agencies can use the Our API to check domain availability and provide their clients personalized suggestions.

Feature icon

Brand Protection

Companies can use our API to generate domain ideas that are similar to their brand, to ensure their brand is protected.

Feature icon

Domain Investors

Domain investors can use the API to check domain availability and make informed investment decisions before anyone else.

Feature icon

Marketing Campaigns

Companies can use the API to generate unique domain name ideas for marketing campaigns and drive higher-quality leads.

Request demo background

Seamlessly integrate our Domain Availability API and discover available domains instantly, enabling smarter domain registration.

pricing background

Documentation

Domain Availability Lookup

The Domain Availability API allows you to check whether a domain is available for registration. When the sug parameter is set to true, it can also provide up to 100 domain suggestions with different TLDs.

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.

Query Parameters

Required
  • apiKey
    Get your API key from our billing dashboard.
  • domain
    The domain to check availability.
Optional
  • sug
    For 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.
  • count
    If sug is true then count can be passed for desired number of suggestions. Default value of count is 5.
  • format
    Two formats are available JSON, XML. If you don't specify the 'format' parameter, the default format will be JSON.

Request

shellnodejsjavapythonphprubyjscsharpgocswiftjquery
SHELL
Loading request...

Response

Loading response...

Status Codes

Success Codes
  • 200  Request is processed successfully.
Failure Codes
  • 400  Please pass domain param correct value e.g. whoisfreaks.com, https://whoisfreaks.com, http://whoisfreaks.com
  • 401  Provided API key is invalid.
  • 401  Provided API key is inactive.
  • 401  Please buy a subscription plan or add api credits, then use this api key.
  • 401  Your subscription is deactivated. Please buy new plan or add api credits for using whoisfreaks APIs.
  • 401  Your subscription is deactivated due to much time payment failure. Please buy a new plan or add api credits for using whoisfreaks APIs.
  • 401  Your account is deactivated.
  • 401  You are blocked due to suspicious activity.
  • 403  We are not providing the whois of this domain extension (e.g., comsdf)
  • 403  Provided domain belongs to an inactive TLD. Please try to use historical WHOIS lookup.
  • 408  Unable to fetch whois data. Please try again.
  • 412  You have exceeded the limit of api plan requests and your subscription is canceled.
  • 413  You have exceeded the limit of api credits requests [allowed_request_no]. Please upgrade your plan.
  • 413  You have exceeded the limit of Surcharge Requests [allowed_surcharge_request_no]. Please upgrade your plan.
  • 429  Please slow down. Your maximum request limit per minute is reached.
  • 500  Internal Server error occurred.
  • 503  Service is unavailable. Please try after some time.
  • 504  Request is timed-out.

Bulk Domain Availability Lookup

The Bulk Domain Availability API allows you to check the availability of up to 100 domains in a single request. You can also provide a custom list of TLDs to verify domain existence based on the specified domain label.

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.

Query Parameters

Required
  • apiKey
    Get your API key from our billing dashboard.
Optional
  • format
    Two formats are available JSON, XML. If you don't specify the 'format' parameter, the default format will be JSON.

Request

shellnodejsjavapythonphprubyjscsharpgocswiftjquery
SHELL
Loading request...

Response

Loading response...

Status Codes

Success Codes
  • 200  Request is processed successfully.
  • 206  Partial response, as an error occurred while processing the request.
Failure Codes
  • 400  Please provide domainNames in request body.
  • 401  Provided API key is invalid.
  • 401  Provided API key is inactive.
  • 401  Please buy a subscription plan or add api credits, then use this api key.
  • 401  Your subscription is deactivated. Please buy new plan or add api credits for using whoisfreaks APIs.
  • 401  Your subscription is deactivated due to much time payment failure. Please buy a new plan or add api credits for using whoisfreaks APIs.
  • 401  Your account is deactivated.
  • 401  You are blocked due to suspicious activity.
  • 403  We are not providing the whois of this domain extension (e.g., comsdf)
  • 403  Provided domain belongs to an inactive TLD. Please try to use historical WHOIS lookup.
  • 412  You have exceeded the limit of api plan requests and your subscription is canceled.
  • 413  The requested list size is [GREATER_THAN_100] which exceeds the maximum list size of 100.
  • 413  You have exceeded the limit of Surcharge Requests [allowed_surcharge_request_no]. Please upgrade your plan.
  • 429  Please slow down. Your maximum request limit per minute is reached.
  • 500  Internal Server error occurred.
  • 503  Service is unavailable. Please try after some time.
  • 504  Request is timed-out.

Domain Discovery API

The Domain Discovery API searches the WhoisFreaks database to retrieve domains that contain a specific keyword or match a pattern (using an asterisk *). For each matched domain, it provides registration and inactive‑from dates. The API also supports the label_length parameter, which lets you control the maximum length of the domain label returned. For example, setting label_length=5 will return only domains with labels shorter than or equal to five characters.

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.

Query Parameters

Required
  • apiKey
    Get your API key from our billing dashboard.
  • keyword
    Use this parameter to search for domain labels that match the specified keyword. Leave this parameter as null to enable use of the pattern parameter.
  • pattern
    Use this parameter to search for domain labels that match a specific pattern. Apply the asterisk (*) as a wildcard for pattern matching, for example, whois*fres returns all domains containing both 'whois' and 'fres'. Leave this parameter as null to enable use of the keyword parameter.
Optional
  • label_length
    Specify this parameter as a label length filter to retrieve all domains whose label length is less than or equal to the given value.
  • page
    Specify page number to access specific page's data. If you don't pass 'page' parameter, default page is 1.

Request

shellnodejsjavapythonphprubyjscsharpgocswiftjquery
SHELL
Loading request...

Response

Loading response...

Status Codes

Success Codes
  • 200  Request is processed successfully.
Failure Codes
  • 400  Please pass domain param correct value e.g. whoisfreaks.com, https://whoisfreaks.com, http://whoisfreaks.com
  • 400  Please provide one of the keyword or pattern, both are not acceptable
  • 400  Please provide keyword or pattern
  • 401  Provided API key is invalid.
  • 401  Provided API key is inactive.
  • 401  Please buy a subscription plan or add api credits, then use this api key.
  • 401  Your subscription is deactivated. Please buy new plan or add api credits for using whoisfreaks APIs.
  • 401  Your subscription is deactivated due to much time payment failure. Please buy a new plan or add api credits for using whoisfreaks APIs.
  • 401  Your account is deactivated.
  • 401  You are blocked due to suspicious activity.
  • 408  Unable to fetch whois data. Please try again.
  • 412  You have exceeded the limit of api plan requests and your subscription is canceled.
  • 413  You have exceeded the limit of api credits requests [allowed_request_no]. Please upgrade your plan.
  • 413  You have exceeded the limit of Surcharge Requests [allowed_surcharge_request_no]. Please upgrade your plan.
  • 429  Please slow down. Your maximum request limit per minute is reached.
  • 500  Internal Server error occurred.
  • 503  Service is unavailable. Please try after some time.
  • 504  Request is timed-out.

Bulk Domain Discovery API

Use the Bulk Domain Discovery API to retrieve domains from the WhoisFreaks database that contain specific keywords, with support for bulk searches of up to 10 keywords per request.

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.

Query Parameters

Required
  • keywords
    Specify a list of up to 100 keywords to retrieve all domain labels that are equal to any of those keywords.

Request

shellnodejsjavapythonphprubyjscsharpgocswiftjquery
SHELL
Loading request...

Response

Loading response...

Status Codes

Success Codes
  • 200  Request is processed successfully.
  • 206  Partial response, as an error occurred while processing the request.
Failure Codes
  • 400  please provide data in request body.
  • 401  Provided API key is invalid.
  • 401  Provided API key is inactive.
  • 401  Please buy a subscription plan or add api credits, then use this api key.
  • 401  Your subscription is deactivated. Please buy new plan or add api credits for using whoisfreaks APIs.
  • 401  Your subscription is deactivated due to much time payment failure. Please buy a new plan or add api credits for using whoisfreaks APIs.
  • 401  Your account is deactivated.
  • 401  You are blocked due to suspicious activity.
  • 408  Unable to process request.
  • 412  You have exceeded the limit of api plan requests and your subscription is canceled.
  • 413  The requested list size is [GREATER_THAN_100] which exceeds the maximum list size of 100.
  • 413  You have exceeded the limit of Surcharge Requests [allowed_surcharge_request_no]. Please upgrade your plan.
  • 429  Please slow down. Your maximum request limit per minute is reached.
  • 500  Internal Server error occurred.
  • 503  Service is unavailable. Please try after some time.
  • 504  Request is timed-out.

FAQs

Common questions on availability checks: authentication, limits, suggestion criteria, and edge cases.

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 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.