Subdomains Lookup API
The Subdomains API retrieves all subdomains under a given domain, including nested ones. For example, querying api.whoisfreaks.com will return all domains beneath that subdomain. It supports after and before filters to fetch subdomains created after or before a specified date, and a status filter to return active, inactive, or both types of subdomains.
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.
Optional
- after
To fetch records created after a specific date. Defaults to the oldest domain record.
- before
To fetch records created before a specific date. Defaults to the current date.
- status
Two statuses are available: inactive and active. active fetches all active subdomains, and inactive fetches all inactive subdomains. To fetch both, do not include this parameter.
- page
Specify Page number to access specific page's data. If you don't pass 'page' parameter, default page is 1.
- format
Two formats are available JSON, XML. If you don't specify the 'format' parameter, the default format will be JSON.
Status Codes
Success Codes
- 200 Request is processed successfully.
Failure Codes
- 400 The domain name field is required and cannot be left empty or null. Please provide a valid domain name to proceed.
- 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.
- 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.
