DNS Araması | DomScan API belgeleri

GET /v1/dns

Sorgu Parametreleri

Parametre	Tür	gerekli
domain	string	gerekli
type	string İzin verilen değerler `AAAAAMXNSTXTSOACNAMECAAPTRSRV` Varsayılan `A`	isteğe bağlı

Yanıt Alanları

Alan	Tür
`domain`	string
`record_type`	string
`records[]`	object[]
`records[]`	object
`records[].type`	string
`records[].name`	string
`records[].data`	string
`records[].ttl`	integer
`records[].priority`	integer
`records[].classification`	string
`status`	string
`dnssec_validated`	boolean
`query_time_ms`	integer
`checked_at`	string
`warnings[]`	object[]
`warnings[]`	object
`warnings[].code`	string
`warnings[].message`	string
`warnings[].severity`	string

Örnek İstek

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/dns?domain=example.com&type=example.com"

Örnek Yanıt

{
  "domain": "google.com",
  "record_type": "TXT",
  "records": [
    {
      "type": "TXT",
      "name": "google.com",
      "data": "v=spf1 include:_spf.google.com ~all",
      "ttl": 300,
      "classification": "spf"
    },
    {
      "type": "TXT",
      "name": "google.com",
      "data": "google-site-verification=abc123",
      "ttl": 300,
      "classification": "verification"
    }
  ],
  "status": "success",
  "dnssec_validated": false,
  "query_time_ms": 37,
  "checked_at": "2026-04-18T21:00:00Z",
  "warnings": [
    {
      "code": "TXT_MULTIPLE_RESPONSES",
      "message": "Domain publishes multiple TXT records; use classification to isolate the security ones.",
      "severity": "info"
    }
  ],
  "meta": {
    "served_by": "pop=unknown country=unknown"
  }
}

POST /v1/dns/bulk

İstek Gövdesi

Alan	Tür	Açıklama
domains gerekli	string[]	Kontrol edilecek tam alan adlarının dizisi
type gerekli	string	DNS kayıt türü (A, AAAA, MX, TXT, NS, vb.)

Tek bir istekte birden fazla alan adı için tek bir kayıt türünü sorgulamak üzere POST /v1/dns/bulk kullanın. domains ve type içeren bir JSON gövdesi gönderin. İstek başına en fazla 25 alan adı desteklenir.

Örnek İstek

curl -H "X-API-Key: your-api-key" -X POST "https://domscan.net/v1/dns/bulk"   -H "Content-Type: application/json"   -d '{
    "domains": ["example.com", "github.com", "cloudflare.com"],
    "type": "MX"
  }'

Örnek Yanıt

{
  "results": [
    {
      "domain": "example.com",
      "record_type": "MX",
      "records": [
        {"type": "MX", "name": "example.com", "data": "mx.example.com", "ttl": 300, "priority": 10}
      ],
      "status": "success",
      "dnssec_validated": true,
      "query_time_ms": 22,
      "checked_at": "2024-01-15T12:00:00Z"
    },
    {
      "domain": "bad domain",
      "record_type": "MX",
      "records": [],
      "status": "error",
      "dnssec_validated": false,
      "query_time_ms": 0,
      "checked_at": "2024-01-15T12:00:00Z",
      "error": {
        "code": "INVALID_DOMAIN",
        "message": "Invalid domain format"
      }
    }
  ],
  "summary": {
    "total": 2,
    "successful": 1,
    "nxdomain": 0,
    "errors": 1,
    "query_time_ms": 31
  },
  "meta": {
    "served_by": "pop=MAD country=ES",
    "record_type": "MX"
  }
}

Yanıt Alanları

Alan	Tür
`results[]`	object[]
`results[]`	object
`results[].domain`	string
`results[].record_type`	string
`results[].records[]`	object[]
`results[].records[]`	object
`results[].records[].type`	string
`results[].records[].name`	string
`results[].records[].data`	string
`results[].records[].ttl`	integer
`results[].records[].priority`	integer
`results[].records[].classification`	string
`results[].status`	string
`results[].dnssec_validated`	boolean
`results[].query_time_ms`	integer
`results[].checked_at`	string
`results[].error`	object
`results[].error.code`	string
`results[].error.message`	string
`summary`	object
`summary.total`	integer
`summary.successful`	integer
`summary.nxdomain`	integer
`summary.errors`	integer
`summary.query_time_ms`	integer
`meta`	object
`meta.served_by`	string
`meta.record_type`	string

GET /v1/dns/all

Sorgu Parametreleri

Parametre	Tür	gerekli
domain	string	gerekli
wildcard_probe	string İzin verilen değerler `1`	isteğe bağlı

Yanıt Alanları

Alan	Tür
`domain`	string
`records`	object
`summary`	object
`summary.has_a`	boolean
`summary.has_aaaa`	boolean
`summary.has_ns`	boolean
`summary.has_mx`	boolean
`summary.has_txt`	boolean
`summary.has_https`	boolean
`summary.has_svcb`	boolean
`summary.ipv6_parity`	string
`warnings[]`	object[]
`warnings[]`	object
`warnings[].code`	string
`warnings[].message`	string
`warnings[].severity`	string
`wildcard`	object
`wildcard.suspected`	boolean
`wildcard.probe_label`	string
`query_time_ms`	integer
`checked_at`	string

Örnek İstek

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/dns/all?domain=example.com&wildcard_probe=example.com"

Örnek Yanıt

{
  "domain": "openai.com",
  "records": {
    "A": [
      {
        "type": "A",
        "name": "openai.com",
        "data": "104.18.33.45",
        "ttl": 300
      }
    ],
    "AAAA": [
      {
        "type": "AAAA",
        "name": "openai.com",
        "data": "2606:4700::6812:212d",
        "ttl": 300
      }
    ],
    "MX": [
      {
        "type": "MX",
        "name": "openai.com",
        "data": "aspmx.l.google.com",
        "ttl": 300,
        "priority": 1
      }
    ],
    "NS": [
      {
        "type": "NS",
        "name": "openai.com",
        "data": "ns1-02.azure-dns.com",
        "ttl": 172800
      },
      {
        "type": "NS",
        "name": "openai.com",
        "data": "ns2-02.azure-dns.net",
        "ttl": 172800
      }
    ],
    "TXT": [
      {
        "type": "TXT",
        "name": "openai.com",
        "data": "v=spf1 include:_spf.google.com ~all",
        "ttl": 300,
        "classification": "spf"
      },
      {
        "type": "TXT",
        "name": "openai.com",
        "data": "v=TLSRPTv1; rua=mailto:[email protected]",
        "ttl": 300,
        "classification": "tls_rpt"
      }
    ]
  },
  "summary": {
    "has_a": true,
    "has_aaaa": true,
    "has_ns": true,
    "has_mx": true,
    "has_txt": true,
    "has_https": false,
    "has_svcb": false,
    "ipv6_parity": "full"
  },
  "warnings": [
    {
      "code": "MX_PRIORITY_SHARED",
      "message": "Multiple MX hosts share the same priority.",
      "severity": "info"
    }
  ],
  "wildcard": {
    "suspected": false,
    "probe_label": "_domscan-probe-4f6a2c.openai.com"
  },
  "query_time_ms": 82,
  "checked_at": "2026-04-18T21:00:00Z"
}