Who it is for
Use the suite for troubleshooting, migration checks, infrastructure research, and security review.
Try a product, outcome, endpoint path, or API topic.
Discover subdomains for a domain using various enumeration techniques.
Discover subdomains for a domain using various enumeration techniques.
Use the suite for troubleshooting, migration checks, infrastructure research, and security review.
Choose this to gather observed public subdomain evidence. A missing name does not prove that no subdomain exists.
Discover subdomains for a domain using various enumeration techniques.
See what each endpoint accepts and returns, its modes and its limits before you integrate.
4-5 Authentication required. See the API reference for the exact cost, including any per-item pricing.
Use documented operations to collect, assess, enrich, verify, compare, protect, or monitor public evidence.
| Parameter | Type | required |
|---|---|---|
| domain | string | required |
| sources |
string
Allowed values
ct
Default
ct
|
optional |
| verify |
string
Allowed values
truefalse10yesno
Default
false
|
optional |
| include_wildcards |
string
Allowed values
truefalse10yesno
Default
false
|
optional |
| limit |
integer
Default
500
|
optional |
| prefer_cache |
string
Allowed values
truefalse10yesno
Default
false
|
optional |
| cursor | string | optional |
| Field | Type |
|---|---|
has_more |
boolean |
next_cursor |
string | null |
cache_age_s |
integer |
domain |
string |
subdomains[] |
object[] |
subdomains[] |
object |
subdomains[].name |
string |
subdomains[].source |
string |
subdomains[].first_seen |
string | null |
subdomains[].verified |
boolean | null |
subdomains[].dns_records |
object |
subdomains[].dns_records.A[] |
string[] |
subdomains[].dns_records.AAAA[] |
string[] |
subdomains[].dns_records.CNAME |
string | null |
wildcards[] |
object[] |
wildcards[] |
object |
wildcards[].pattern |
string |
wildcards[].source |
string |
wildcards[].first_seen |
string | null |
summary |
object |
summary.total_found |
integer |
summary.returned |
integer |
summary.verified_count |
integer |
summary.unverified_count |
integer |
summary.verification_unknown_count |
integer |
summary.sources_used[] |
string[] |
summary.apex_included |
boolean |
summary.wildcard_suppressed_count |
integer |
summary.wildcard_returned_count |
integer |
intelligence_summary |
object |
intelligence_summary.data_sources[] |
string[] |
intelligence_summary.source_count |
integer |
intelligence_summary.cache_status |
string |
intelligence_summary.returned_count |
integer |
intelligence_summary.total_found |
integer |
intelligence_summary.truncated |
boolean |
intelligence_summary.limit |
integer |
intelligence_summary.verification_requested |
boolean |
intelligence_summary.include_wildcards |
boolean |
intelligence_summary.verified_count |
integer |
intelligence_summary.verified_ratio |
number | null |
intelligence_summary.live_dns_record_count |
integer |
intelligence_summary.apex_included |
boolean |
intelligence_summary.wildcard_suppressed_count |
integer |
intelligence_summary.wildcard_returned_count |
integer |
intelligence_summary.first_seen_oldest |
string | null |
intelligence_summary.first_seen_newest |
string | null |
intelligence_summary.warning_count |
integer |
warnings[] |
string[] |
meta |
object |
meta.query_time_ms |
integer |
meta.cached |
boolean |
meta.stale |
boolean |
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/subdomains?domain=example.com&sources=ct&verify=yes&include_wildcards=1&limit=500&prefer_cache=false"const response = await fetch("https://domscan.net/v1/subdomains?domain=example.com&sources=ct&verify=yes&include_wildcards=1&limit=500&prefer_cache=false", {
headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);import os
import requests
response = requests.get(
"https://domscan.net/v1/subdomains?domain=example.com&sources=ct&verify=yes&include_wildcards=1&limit=500&prefer_cache=false",
headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/subdomains?domain=example.com&sources=ct&verify=yes&include_wildcards=1&limit=500&prefer_cache=false", nil)
if err != nil {
panic(err)
}
req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
data, err := io.ReadAll(resp.Body)
if err != nil {
panic(err)
}
fmt.Println(resp.Status, string(data))
}require "json"
require "net/http"
uri = URI("https://domscan.net/v1/subdomains?domain=example.com&sources=ct&verify=yes&include_wildcards=1&limit=500&prefer_cache=false")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body)){
"domain": "example.com",
"subdomains": [
{
"name": "api.example.com",
"source": "crtsh",
"first_seen": "2025-01-15T00:00:00Z",
"verified": true,
"dns_records": {
"A": [
"example"
],
"AAAA": [
"example"
],
"CNAME": "example"
}
}
],
"summary": {
"total_found": 1,
"returned": 1,
"verified_count": 1,
"unverified_count": 1,
"verification_unknown_count": 1,
"sources_used": [
"ct"
],
"apex_included": false,
"wildcard_suppressed_count": 1,
"wildcard_returned_count": 1
},
"intelligence_summary": {
"data_sources": [
"ct"
],
"source_count": 1,
"cache_status": "live",
"returned_count": 1,
"total_found": 1,
"truncated": false,
"limit": 1,
"verification_requested": false,
"include_wildcards": false,
"verified_count": 1,
"verified_ratio": 0.5,
"live_dns_record_count": 1,
"apex_included": false,
"wildcard_suppressed_count": 1,
"wildcard_returned_count": 1,
"first_seen_oldest": "example",
"first_seen_newest": "example",
"warning_count": 1
},
"meta": {
"query_time_ms": 1,
"cached": false,
"stale": false
},
"has_more": false,
"next_cursor": "example",
"cache_age_s": 1,
"wildcards": [
{
"pattern": "*.example.com",
"source": "ct",
"first_seen": "example"
}
],
"warnings": [
"example"
]
}
200 OK202 Accepted400 Bad Request401 Unauthorized402 Payment Required429 Too Many Requests503 Service Unavailable504 Gateway TimeoutUse the API reference for Subdomain Finder to review parameters, response fields, examples, status codes, and supported operation modes.
Unknown or partial means we could not fully confirm the result. Keep the status, confidence, freshness and any limits in mind when you act on it.
The price depends on the check and the mode you choose. The API reference shows the current credit cost, whether you need an API key, and any per-item pricing.
Used by people at these companies