API referansı

Alt Domain Bulucu API ürünü

Çeşitli numaralandırma tekniklerini kullanarak bir alanın alt alan adlarını keşfedin. Bir işlem seçmek ve belgelenen yanıt sözleşmesini entegre etmek için bu referansı kullanın.

İşlemler

GET /v1/subdomains API referansını görüntüle
POST /v1/subdomains/bulk API referansını görüntüle

GET /v1/subdomains

İşlem: getSubdomains Krediler ve kimlik doğrulama: 4-5 Kimlik doğrulama gerekli
GET /v1/subdomains

Sorgu Parametreleri

Parametre Tür gerekli
domain string gerekli
sources string
İzin verilen değerler ct
Varsayılan ct
isteğe bağlı
verify string
İzin verilen değerler truefalse10yesno
Varsayılan false
isteğe bağlı
include_wildcards string
İzin verilen değerler truefalse10yesno
Varsayılan false
isteğe bağlı
limit integer
Varsayılan 500
isteğe bağlı
prefer_cache string
İzin verilen değerler truefalse10yesno
Varsayılan false
isteğe bağlı

Yanıt Alanları

Alan Tür
domain string
subdomains[] object[]
subdomains[] object
subdomains[].name string
subdomains[].source string
subdomains[].first_seen string | null
subdomains[].verified boolean
subdomains[].dns_records object
subdomains[].dns_records.A[] 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.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

Örnek İstek

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/subdomains?domain=example.com&sources=example.com&verify=yes&include_wildcards=1&limit=500&prefer_cache=false"

Örnek Yanıt

{
  "domain": "example.com",
  "subdomains": [
    {
      "name": "api.example.com",
      "source": "crtsh",
      "first_seen": "2025-01-15T00:00:00Z",
      "verified": true,
      "dns_records": {
        "A": [
          "string"
        ],
        "CNAME": "string"
      }
    }
  ],
  "wildcards": [
    {
      "pattern": "*.example.com",
      "source": "ct",
      "first_seen": "string"
    }
  ],
  "summary": {
    "total_found": 1,
    "returned": 1,
    "verified_count": 1,
    "unverified_count": 1,
    "sources_used": [
      "ct"
    ],
    "apex_included": true,
    "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": true,
    "limit": 1,
    "verification_requested": true,
    "include_wildcards": true,
    "verified_count": 1,
    "verified_ratio": 1,
    "live_dns_record_count": 1,
    "apex_included": true,
    "wildcard_suppressed_count": 1,
    "wildcard_returned_count": 1,
    "first_seen_oldest": "string",
    "first_seen_newest": "string",
    "warning_count": 1
  },
  "warnings": [
    "string"
  ],
  "meta": {
    "query_time_ms": "2026-04-15T12:00:00Z",
    "cached": true,
    "stale": true
  }
}

POST /v1/subdomains/bulk

İşlem: bulkGetSubdomains Krediler ve kimlik doğrulama: 4-5 Kimlik doğrulama gerekli
POST /v1/subdomains/bulk

Gövde Parametreleri

Parametre Tür gerekli
domains string[] gerekli
verify boolean
Varsayılan false
isteğe bağlı
include_wildcards boolean
Varsayılan false
isteğe bağlı
limit integer
Varsayılan 500
isteğe bağlı

Yanıt Alanları

Alan Tür
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

Örnek İstek

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
}'

Örnek Yanıt

{
  "results": [
    null
  ],
  "meta": {
    "total": 1,
    "succeeded": 1,
    "failed": 1,
    "max_items": 10,
    "credits_per_item": 1,
    "duration_ms": 1
  }
}

Referans kaynakları