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.
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.
Fields Description
status
Indicates if the request was successful
true
total_records
Total number of domains found
3
query_time
Timestamp when the query was executed
2026-01-19 09:01:07
page_no
Current page number
1
total_pages
Total number of pages available
1
domains
List of domains returned in the response
domain
Domain name
whoisfreaks.com
create_date
Domain creation date
2019-03-19
expiry_date
Domain expiration date
2026-03-19
last_seen
Last time the domain was observed
2026-01-18
is_dropped
Indicates whether the domain is dropped
false
