> For the complete documentation index see https://domscan.net/llms.txt. Markdown versions of every docs page are available by appending .md to the page URL.

Source: https://domscan.net/tr/docs/subdomains

# Alt alan adı bulucu

Alan adı analizi için DomScan API: Hayır. Bu, eksiksizliği garanti edilmeyen pasif kapsamdır.

Hayır. Bu, eksiksizliği garanti edilmeyen pasif kapsamdır. Dahili adlar ve kaynak veri kümelerinde bulunmayan genel ana bilgisayarlar görünmez. DNS doğrulaması ek ad aramaz.

GET /v1/subdomains?domain=example.com&sources=ct kullanın. ct değeri uyumluluk işlem hattını seçer, her girdi ise gerçek kanıt kaynağını bildirir. Yalnızca önbellek isteklerindeki eksik sonuçlar 202, tüm kaynak hataları 503 döndürür. Her ikisinde de krediler iade edilir.

GET /v1/subdomains

#### Sorgu parametreleri

| Parametre | Tür | Açıklama |
| --- | --- | --- |
| domain gerekli | string | Alt alan adları bulunacak kök domain (ör. "github.com") |
| prefer_cache isteğe bağlı | boolean token | Yalnızca önbellekteki sonuçları sunar. Yeni veya eski önbellek yoksa API 202 döndürür, arka plan yenilemesini kuyruğa alır ve istek kredilerini iade eder. Kabul edilen değerler: true, false, 1, 0, yes ve no. Varsayılan: false. |
| sources isteğe bağlı | string | Uyumluluk seçicisi. Yalnızca `ct` kabul edilir. Bu değer pasif keşif işlem hattını başlatır, ancak her sonuç kanıtı sağlayan kaynağı bildirir: `crtsh`, `crtname`, `hackertarget`, `threatminer`, `wayback` veya `certspotter`. Eski önbellek kayıtları `ct` bildirebilir. |
| verify isteğe bağlı | boolean token | DNS denetimini yalnızca yanıt için seçilmiş adlarda yapar. Doğrulama yeni adlar keşfetmez. Kabul edilen değerler: `true`, `false`, `1`, `0`, `yes` ve `no`. Varsayılan: `false`. |
| include_wildcards isteğe bağlı | boolean token | Joker karakterli sertifika kanıtlarını ayrı bir `wildcards` dizisinde döndürür. Joker karakterler somut ana bilgisayar adı sonuçlarına karıştırılmaz. Kabul edilen değerler: `true`, `false`, `1`, `0`, `yes` ve `no`. Varsayılan: `false`. |
| limit isteğe bağlı | integer | Döndürülecek en fazla somut ana bilgisayar adı girdisi. 1 ile 2000 arasında bir tam sayı girin. Varsayılan: 500. |
| cursor isteğe bağlı | string | Önceki sayfadaki `next_cursor` değeri. Bkz. [sayfalama](https://domscan.net/docs/response-format#pagination). |

#### Kullanım alanları

- Saldırı yüzeyi haritalama ve güvenlik denetimleri

- Unutulmuş veya gölge BT olabilecek ana bilgisayar adlarını inceleme

- Edinim öncesi teknik durum tespiti

- Altyapının rekabet analizi

- Hata ödülü keşfi

#### Yanıt alanları

| Alan | Açıklama |
| --- | --- |
| `subdomains[].name` | Döndürülen ana bilgisayar adı. Kaynak apex değerini içeriyorsa apex de görünebilir. |
| `subdomains[].source` | Açık kaynak etiketleriyle genel ana bilgisayar adı kanıtlarını inceleyin |
| `subdomains[].first_seen` | CT destekli girdiler bulunan en erken sertifika not-before değerini bildirir. Pasif yedek girdiler null döndürebilir. |
| `subdomains[].verified` | Yalnızca verify etkin olduğunda ve döndürülen ana bilgisayar adının DNS çözümlemesi (A, AAAA veya CNAME) başarılı olduğunda true olur. verify etkin ancak DNS zamanında yanıt vermediğinde null olur. Diğer durumlarda false olur. |
| `subdomains[].dns_records` | Döndürülen ana bilgisayar adının isteğe bağlı doğrulamasından gelen A, AAAA ve CNAME kayıtları veya null. Bu alan sonuca ad eklemez. |
| `summary.total_found` | Yanıt limiti uygulanmadan önce bulunan toplam somut ana bilgisayar adı girdisi. Kaynak apex değerini içeriyorsa apex de bu sayıya dahildir. |
| `summary.verified_count` | İsteğe bağlı DNS doğrulaması sırasında çözümlenen döndürülmüş ana bilgisayar adlarının sayısı. |

#### HTTP durum kodları

| HTTP durum kodları | Açıklama |
| --- | --- |
| `200` OK | İstek başarılı |
| `202` Kabul edildi | Yalnızca önbellek kullanılan alt alan adı isteğinde önbellek ıskası arka plan yenilemesi için kabul edildi. Kredi alınmaz; Retry-After gecikmesinden sonra tekrar deneyin. |
| `400` Hatalı İstek | Geçersiz parametreler |
| `402` Ödeme Gerekli | Bu isteği çalıştırmak için yeterli krediniz yok. |
| `503` Hizmet Kullanılamıyor | Yukarı akış hizmeti kullanılamıyor veya geçici olarak hız sınırı uyguluyor. |
| `504` Ağ Geçidi Zaman Aşımı | Yukarı akış sorgusu zaman aşımına uğradı. |

#### Örnek istek

```bash
curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/subdomains?domain=example.com&sources=ct&include_wildcards=yes&limit=100"

curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/subdomains?domain=example.com&sources=ct&verify=yes&limit=50"

curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/subdomains?domain=example.com&prefer_cache=1"
```

```python
import requests

domscan = requests.Session()
domscan.headers.update({"X-API-Key": "your-api-key"})

response = domscan.get(
    "https://domscan.net/v1/subdomains",
    params={
        "domain": "example.com",
        "sources": "ct",
        "verify": "yes",
        "include_wildcards": "yes",
        "limit": 100
    }
)
data = response.json()

print(f"Returned {data['summary']['returned']} hostname entries")
print(f"Verified: {data['summary']['verified_count']}")

live_subs = [s for s in data['subdomains'] if s['verified']]
for sub in live_subs[:10]:
    print(f"  {sub['name']}")
```

```javascript
const domscanFetch = (url, options = {}) =>
  fetch(url, {
    ...options,
    headers: { ...options.headers, "X-API-Key": "your-api-key" },
  });

const response = await domscanFetch(
  'https://domscan.net/v1/subdomains?' + new URLSearchParams({
    domain: 'example.com',
    sources: 'ct',
    verify: 'yes',
    include_wildcards: 'yes',
    limit: '100'
  })
);
const data = await response.json();

console.log(`Returned ${data.summary.returned} hostname entries`);
console.log(`Verified: ${data.summary.verified_count}`);

data.subdomains
  .filter(s => s.verified)
  .forEach(s => console.log(`  ${s.name}`));
```

#### Örnek yanıt

```json
{
  "domain": "example.com",
  "subdomains": [
    {
      "name": "api.example.com",
      "source": "crtsh",
      "first_seen": "2025-01-15T00:00:00Z",
      "verified": true,
      "dns_records": {
        "A": ["192.0.2.10"],
        "CNAME": null
      }
    }
  ],
  "wildcards": [
    {
      "pattern": "*.example.com",
      "source": "crtsh",
      "first_seen": "2024-11-20T00:00:00Z"
    }
  ],
  "summary": {
    "total_found": 1,
    "returned": 1,
    "verified_count": 1,
    "unverified_count": 0,
    "sources_used": ["crtsh"],
    "apex_included": false,
    "wildcard_suppressed_count": 1,
    "wildcard_returned_count": 1
  },
  "intelligence_summary": {
    "data_sources": ["crtsh"],
    "source_count": 1,
    "cache_status": "live",
    "returned_count": 1,
    "total_found": 1,
    "truncated": false,
    "limit": 100,
    "verification_requested": true,
    "include_wildcards": true,
    "verified_count": 1,
    "verified_ratio": 1,
    "live_dns_record_count": 1,
    "apex_included": false,
    "wildcard_suppressed_count": 1,
    "wildcard_returned_count": 1,
    "first_seen_oldest": "2025-01-15T00:00:00Z",
    "first_seen_newest": "2025-01-15T00:00:00Z",
    "warning_count": 0
  },
  "meta": {
    "query_time_ms": 184,
    "cached": false
  }
}
```

#### 202 Kabul edildi

```json
{
  "status": "pending",
  "code": "CACHE_MISS_REFRESH_QUEUED",
  "message": "Try again in a moment",
  "domain": "example.com",
  "retry_after": 30,
  "credits_charged": 0,
  "billing_status": "not_charged",
  "request_id": "m8abc12-x9y8"
}
```

POST /v1/subdomains/bulk Kredi: 4-5/item

#### Sorgu parametreleri

| Parametre | Tür | gerekli |
| --- | --- | --- |
| dry_run | string İzin verilen değerler `true` | isteğe bağlı |

#### 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 istek

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

```javascript
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);
```

```python
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())
```

```go
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))
}
```

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

#### Örnek yanıt

```json
{
  "results": [
    {
      "input": "example",
      "data": {}
    }
  ],
  "meta": {
    "total": 1,
    "succeeded": 1,
    "failed": 1,
    "max_items": 10,
    "credits_per_item": 1,
    "duration_ms": 1
  }
}
```

#### HTTP durum kodları

- `200` OK
- `400` Hatalı İstek
- `401` Yetkisiz
- `402` Ödeme Gerekli
- `409` HTTP 409
- `422` HTTP 422
- `429` Çok Fazla İstek
