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.
Authorize every request with your API key, passed either as a header or as a query parameter:
X-apiKeyapiKeyThis 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)
Besides the response body, every response carries custom headers you can use to track credit usage, and concurrency usage on endpoints that enforce a concurrency limit. See the Custom Response Headers documentation and the endpoints with concurrency limits for more details.
X-Concurrent-Threadsheaderconcurrency-limited endpointsSpecifies the maximum number of concurrent requests allowed.
X-Concurrent-Threads-Activeheaderconcurrency-limited endpointsIndicates the number of active concurrent requests being processed.
X-AF-Credits-Costheaderall responsesSpecifies the number of credits consumed by the current request.
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]