Underdomänsökare API-referens
Upptäck underdomäner för en domän med hjälp av olika uppräkningsmetoder. Använd den här referensen för att välja rätt endpoint och se exakt vad den returnerar.
Operationer
GET /v1/subdomains
GET
/v1/subdomains
Krediter: 4-5
Frågeparametrar
| Parameter | Typ | obligatorisk |
|---|---|---|
| domain | string | obligatorisk |
| sources |
string
Tillåtna värden
ct
Standard
ct
|
valfri |
| verify |
string
Tillåtna värden
truefalse10yesno
Standard
false
|
valfri |
| include_wildcards |
string
Tillåtna värden
truefalse10yesno
Standard
false
|
valfri |
| limit |
integer
Standard
500
|
valfri |
| prefer_cache |
string
Tillåtna värden
truefalse10yesno
Standard
false
|
valfri |
| cursor | string | valfri |
Svarsfält
| Fält | Typ |
|---|---|
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 |
Exempelbegäran
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))Exempelsvar
{
"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"
]
}
HTTP-statuskoder
200OK202Accepterad400Felaktig begäran401Obehörig402Betalning krävs429För många begäranden503Tjänsten är inte tillgänglig504Gateway-timeout
POST /v1/subdomains/bulk
POST
/v1/subdomains/bulk
Krediter: 4-5/item
Frågeparametrar
| Parameter | Typ | obligatorisk |
|---|---|---|
| dry_run |
string
Tillåtna värden
true
|
valfri |
Brödtextparametrar
| Parameter | Typ | obligatorisk |
|---|---|---|
| domains | string[] | obligatorisk |
| verify |
boolean
Standard
false
|
valfri |
| include_wildcards |
boolean
Standard
false
|
valfri |
| limit |
integer
Standard
500
|
valfri |
Svarsfält
| Fält | Typ |
|---|---|
results[] |
unknown[] |
meta |
object |
meta.total |
integer |
meta.succeeded |
integer |
meta.failed |
integer |
meta.max_items |
integer |
meta.credits_per_item |
integer |
meta.duration_ms |
integer |
Exempelbegäran
curl -X POST "https://domscan.net/v1/subdomains/bulk" \
-H "Content-Type: application/json" \
-H "X-API-Key: $DOMSCAN_API_KEY" \
-d '{
"domains": [
"example.com",
"cloudflare.com"
],
"verify": false,
"limit": 500
}'const response = await fetch("https://domscan.net/v1/subdomains/bulk", {
method: "POST",
headers: { "X-API-Key": process.env.DOMSCAN_API_KEY, "Content-Type": "application/json" },
body: JSON.stringify({
"domains": [
"example.com",
"cloudflare.com"
],
"verify": false,
"limit": 500
}),
});
const data = await response.json();
console.log(data);import os
import requests
response = requests.post(
"https://domscan.net/v1/subdomains/bulk",
headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
json={
"domains": [
"example.com",
"cloudflare.com",
],
"verify": False,
"limit": 500,
},
)
print(response.json())package main
import (
"fmt"
"io"
"net/http"
"os"
"strings"
)
func main() {
body := strings.NewReader(`{
"domains": [
"example.com",
"cloudflare.com"
],
"verify": false,
"limit": 500
}`)
req, err := http.NewRequest(http.MethodPost, "https://domscan.net/v1/subdomains/bulk", body)
if err != nil {
panic(err)
}
req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))
req.Header.Set("Content-Type", "application/json")
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/bulk")
request = Net::HTTP::Post.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")
request["Content-Type"] = "application/json"
request.body = JSON.generate({
"domains" => [
"example.com",
"cloudflare.com"
],
"verify" => false,
"limit" => 500
})
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))Exempelsvar
{
"results": [
{
"input": "example",
"data": {}
}
],
"meta": {
"total": 1,
"succeeded": 1,
"failed": 1,
"max_items": 10,
"credits_per_item": 1,
"duration_ms": 1
}
}
HTTP-statuskoder
200OK400Felaktig begäran401Obehörig402Betalning krävs409HTTP 409422HTTP 422429För många begäranden