Loading
Loading
Retrieve a complete list of subdomains associated with any domain, along with detailed lifecycle data including discovery date, last seen timestamp, and activity status.
The Subdomain Lookup API provides paginated results with advanced filtering by date range and activity status. Each result includes the subdomain name, first seen date, last seen date, and inactivity information when applicable.
Pass your API key as the apiKey parameter in every request.
This is version v1.0 of the API.
The following parameters can be used in your API requests. All parameters are passed as query string parameters.
formatoptionalStringdefault: jsonResponse format: 'json' (default) or 'xml'.
domainrequiredStringThe domain for which you would like to retrieve subdomains.
beforeoptionalStringFetch records created before a specific date.
afteroptionalStringFetch records created after a specific date.
statusoptionalStringTwo statuses are available: inactive and active. active fetches all active subdomains, and inactive fetches all inactive subdomains.
pageoptionalStringdefault: 1Specify page number to access specific page data.
A successful request returns a 200 OK response with a JSON object containing paginated subdomain data. See the response preview on the right for the full JSON structure.
domainThe domain name for which subdomains are retrieved.
statusIndicates whether the request was successfully processed or not.
query_timeTimestamp showing when the API request was executed.
current_pageThe current page number of the paginated response.
total_pagesTotal number of pages available for the given query. Each page has 100 subdomain entries.
total_recordsTotal number of subdomains found for the domain.
subdomain (String), first_seen (String), last_seen (String), inactive_from (String)
See the HTTP Status Codes documentation for a complete reference of common API errors and HTTP status codes.
after date must be earlier than before date.
after date cannot be greater than the current date.
before date cannot be greater than the current date.
Please provide a valid domain name in the "domain" parameter.
Unable to fetch whois data. Please try again. [For Technical Support email at: support@apifreaks.com]