DNS et infrastructure · Produit DomScan

API Recherche de Sous-domaine

Découvrez les sous-domaines d'un domaine en utilisant diverses techniques d'énumération.

Ce que vous obtenez

Découvrez les sous-domaines d'un domaine en utilisant diverses techniques d'énumération.

SynchroneLotRESTMCPSDKOutil interactif

Choisissez ce produit lorsque

À qui s’adresse ce produit

Utilisez cette suite pour le dépannage, les contrôles de migration, la recherche d’infrastructure et les examens de sécurité.

Choisissez ce produit lorsque

À choisir pour recueillir des éléments de preuve sur des sous-domaines publics observés. Un nom absent ne prouve pas qu’aucun sous-domaine n’existe.

Ce que vous obtenez

Découvrez les sous-domaines d'un domaine en utilisant diverses techniques d'énumération.

Endpoints

Voyez ce que chaque endpoint accepte et renvoie, ses modes et ses limites avant d'intégrer.

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

Crédits et authentification

4-5 Authentification requise. Consultez la référence de l'API pour le coût exact, y compris les éventuels tarifs par élément.

Opération exemple

Utilisez des opérations documentées pour collecter, évaluer, enrichir, vérifier, comparer, protéger ou surveiller des preuves publiques.

GET /v1/subdomains Crédits: 4-5

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
cursor string optionnel

Champs de réponse

Champ 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

Exemple de requête

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))

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": [
          "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"
  ]
}

Codes de statut HTTP

  • 200 OK
  • 202 Accepté
  • 400 Requête incorrecte
  • 401 Non autorisé
  • 402 Paiement requis
  • 429 Trop de requêtes
  • 503 Service indisponible
  • 504 Délai d’attente de la passerelle dépassé

Questions fréquentes

Où trouver la référence des requêtes et réponses de Recherche de Sous-domaine ?

Utilisez la référence API de Recherche de Sous-domaine pour consulter les paramètres, les champs de réponse, les exemples, les codes d’état et les modes d’opération pris en charge.

Comment interpréter les résultats inconnus ou incomplets de Recherche de Sous-domaine ?

Inconnu ou partiel signifie que nous n'avons pas pu confirmer entièrement le résultat. Gardez en tête le statut, la confiance, la fraîcheur et les éventuelles limites avant d'agir.

Comment Recherche de Sous-domaine est-il tarifé ?

Le prix dépend de la vérification et du mode choisi. La référence de l'API indique le coût actuel en crédits, si une clé API est nécessaire et les éventuels tarifs par élément.

Utilisé par des équipes de ces entreprises

InstantOutseerMongoDBRespondentSage Expense ManagementInstantlyD.R. HortonWhatConvertsAdobeLLM Pulse