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.
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.
formatoptionalStringdefault: jsonResponse format. Possible values are:
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.
subdomainsReturns an array of subdomain objects. Each object contains detailed information about an individual subdomain.
Each object in the subdomains array contains the following fields:
subdomainThe discovered subdomain associated with the given domain.
first_seenThe date when the subdomain was first discovered.
last_seenThe most recent date when the subdomain was observed. This field is only returned if the subdomain has been re-detected after its initial discovery.
inactive_fromThe date from which the subdomain is considered inactive. This field appears only if the subdomain is no longer active.
The API uses standard HTTP status codes to indicate the success or failure of requests. For common status codes like 429 (Too Many Requests), refer to the general API documentation.
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.