EN English ES Español DE Deutsch FR Français PT Português JP 日本語 CN 中文 AR العربية IT Italiano KR 한국어 RU Русский NL Nederlands TR Türkçe PL Polski SE Svenska
Référence API

API Recherche de Sous-domaine

Découvrez les sous-domaines d'un domaine en utilisant diverses techniques d'énumération. Utilisez cette référence pour choisir une opération et intégrer son contrat de réponse documenté.

Voir la page du produit

Opérations

GET /v1/subdomains Voir la référence API
POST /v1/subdomains/bulk Voir la référence API

GET /v1/subdomains

Opération: getSubdomains Crédits et authentification: 4-5 Authentification requise
GET /v1/subdomains

Paramètres de Requête

Paramètre Type requis
domain string requis
sources string
Valeurs autorisées ct
Défaut ct
optionnel
verify string
Valeurs autorisées truefalse10yesno
Défaut false
optionnel
include_wildcards string
Valeurs autorisées truefalse10yesno
Défaut false
optionnel
limit integer
Défaut 500
optionnel
prefer_cache string
Valeurs autorisées truefalse10yesno
Défaut false
optionnel

Champs de Réponse

Champ Type
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

Exemple de Requête

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"

Exemple de Réponse

{
  "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

Opération: bulkGetSubdomains Crédits et authentification: 4-5 Authentification requise
POST /v1/subdomains/bulk

Paramètres du Corps

Paramètre Type requis
domains string[] requis
verify boolean
Défaut false
optionnel
include_wildcards boolean
Défaut false
optionnel
limit integer
Défaut 500
optionnel

Champs de Réponse

Champ Type
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

Exemple de Requête

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

Exemple de Réponse

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

Ressources de référence

OpenAPI 3.0 Postman MCP