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.