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.
Important References
- For details on request limits and handling rate limiting, refer here
- For a complete overview of API credit consumption and usage, refer here
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.
Fields Description
domain
Main domain for which subdomains are listed
google.com
status
Indicates whether the API request was successful
true
query_time
Timestamp when the subdomain query was executed
2025-05-22T16:00:50.978835309
current_page
Current page number of paginated results
3
total_pages
Total number of pages available in the result set
182
total_records
Total number of subdomains found for the domain
18128
subdomains
List of discovered subdomains for the given domain
subdomain
Fully qualified subdomain name
liqckdx.sites.google.com
first_seen
Date when the subdomain was first observed
2022-05-17
last_seen
Last observed date of the subdomain
2025-05-01
inactive_from
Date from which subdomain became inactive (if applicable)
