v1

latestOpenAPI 3.0.3Apache 2.02026-07-1710919.5 KB
domain

Lookup subdomains for domain.

Returns an array of subdomains.

The response contains the subdomains only, the domain not included (eg.: ["one", "two", ...]).

If a FQDN is requested than the domain name will be taken out and used in the lookup (eg.: /api/lookup/columbus.elmasy.com will be the same as /api/lookup/elmasy.com)

If Accept header is set to text/plain, this endpoint returns a newline delimetered text of the list (eg.: one\ntwo\nthree).

Note

  • The subdomain part will be trimmed (eg.: /api/lookup/totally.invalid.elmasy.com will be the same as /api/lookup/elmasy.com).
  • If domain not found, the server saves for later process.
  • Only the subdomains are sent in the response to save CPU and RAM on the server side and save bandwith on both client- and server-side.
get/api/lookup/{domain}

Path parameters

domainstring required

Domain to get the subdomains.

Query parameters

daysinteger
  • If days greater than 0, returns subdomains that has a valid DNS record in the last days days.
  • If days is 0, returns subdomains that has a valid DNS record regardless of the age.
  • If days is -1, returns every known subdomains.

If omitted, returns every subdomain including historical and invalid ones (aka the default days is -1).

Response

success

string[] required
All 10 operations