Domain Management API

Endpoint

‍

To discover subdomains for a base domain, make a GET request to the following endpoint:

‍

GET /domainer/api/domains/subdomains/{baseDomain}

‍

Parameters & Filtering

‍

This endpoint offers several parameters to refine your search:

‍

Path Parameters

• baseDomain (string, required): The base domain you want to search. Example: github.com.

Query Parameters

• limit (integer, optional): Sets the maximum number of results to return. The default is 100.
• level (string, optional): Filters subdomains by their depth relative to the base domain. Options include:
  • ALL: (Default) Returns all subdomains found at any depth.
  • IMMEDIATE: Returns only direct subdomains (e.g., api.github.com but not v3.api.github.com).
  • MAX_DEPTH: Returns only the subdomains that are at the deepest level found.

Information Provided

‍

The endpoint returns a simple JSON object containing a results array with a list of the subdomains found as strings.

‍

{
  "results": [
    "api.github.com",
    "docs.github.com",
    "gist.github.com",
    "pages.github.com",
    "raw.github.com"
  ]
}

‍

Common Use Cases

‍

This endpoint is built for asset discovery, security reconnaissance, DNS zone enumeration, and infrastructure mapping.

‍

Next Steps

‍

View the full Domain Management API Reference

‍

‍