Canlı
Hizmet durumu
Entegrasyondan önce canlı hizmet durumunu ve belgelenmiş hata yanıtlarını kontrol edin.
Kategori
DNS ve Altyapı
Uç Noktalar
2
Temel Özellikler
7
Sıkça Sorulan Sorular
4
Harika şirketlerdeki insanlar tarafından kullanılıyor
Entegrasyondan önce güven sinyalleri
Şeffaf dokümanlar, kimliği doğrulanmış istekler ve görünür güvenilirlik ayrıntıları, yayına almadan önce DomScan’i değerlendirmeyi kolaylaştırır.
OpenAPI
API materyalleri
OpenAPI, Swagger, Postman, CLI, SDK ve MCP bağlantıları bir tık uzakta.
API anahtarları
Korumalı erişim
Kimliği doğrulanmış endpointler, çağrıdan önce net kredi maliyetleriyle API anahtarları kullanır.
10,000
Ücretsiz hak
Aylık 10.000 krediyle başlayın ve yalnızca kullanım arttığında yükseltin.
Bu API neyi yayına almanıza yardımcı olur
Bu sayfayı üretim özeti olarak kullanın: endpointler, örnekler, yanıt yapısı ve DomScan’i ürününüze bağlamak için gereken workflow parçaları.
Domain kontrollerini, DNS istihbaratını, risk sinyallerini veya zenginleştirmeyi onboarding, arama ve dahili araçlara gömün.
Tekrarlanan manuel sorguları planlı işler, uyarılar ve yeniden üretilebilir araştırma adımlarıyla değiştirin.
Sağlayıcı sayfalarını kazımak yerine öngörülebilir alanlar, belgelenmiş durum kodları ve kredi maliyetleri kullanın.
OpenAPI, SDK, Postman veya MCP üzerinden agent’ları, panoları, SOAR playbook’larını ve CRM’leri besleyin.
Entegrasyon workflow’u
İlk istekten tekrarlanabilir üretim kullanımına giden basit yol.
Bir kez doğrulayın
API anahtarınızı belgelenmiş header ile gönderin ve servisler arasında istekleri tutarlı tutun.
Örneklerle sorgulayın
curl ve HTTP örneklerinden başlayın, sonra parametreleri uygulama kodunuza eşleyin.
İşletin ve izleyin
Retry, log ve uyarılar için durum kodlarını, kredi maliyetlerini ve yanıt alanlarını kullanın.
Geliştirici kiti
Bu sayfadan makine tarafından okunabilir dokümanlara, istek koleksiyonlarına, SDK’lere veya agent araçlarına geçin.
OpenAPI şeması
Client üretin veya her istek ve yanıt şeklini inceleyin.
Postman koleksiyonuManuel test ve ekip devri için hazır istekleri içe aktarın.
SDK’ler ve CLIBoilerplate yazmak yerine bakımı yapılan paketleri ve komut satırı workflow’larını kullanın.
MCP entegrasyonuDomain intelligence’ı AI agent’larına ve dahili asistan workflow’larına açın.
Parametre ve yanıt haritası
Endpoint’i client’ınıza bağlamadan önce girdileri, çıktı alanlarını ve durum kodlarını tarayın.
Parametre
domainverifyinclude_wildcardsprefer_cachelimitdomains
Örnek Yanıt
domainsubdomainswildcardssummarysummary.total_foundsummary.returnedsummary.verified_countsummary.unverified_countsummary.sources_usedsummary.apex_includedsummary.wildcard_suppressed_countsummary.wildcard_returned_count
HTTP Durum Kodları
200202400401402429503504
Uç Noktalar
GET
/v1/subdomains
domainverifyinclude_wildcardsprefer_cachelimit
POST
/v1/subdomains/bulk
domainsverifyinclude_wildcardslimit
Entegrasyondan önce güven sinyalleri
Şeffaf dokümanlar, kimliği doğrulanmış istekler ve görünür güvenilirlik ayrıntıları, yayına almadan önce DomScan’i değerlendirmeyi kolaylaştırır.
Hizmet durumu
API materyalleri
OpenAPI, Swagger, Postman, CLI, SDK ve MCP bağlantıları bir tık uzakta.
API anahtarları
Korumalı erişim
Kimliği doğrulanmış endpointler, çağrıdan önce net kredi maliyetleriyle API anahtarları kullanır.
Ücretsiz hak
Ücretsiz Kaydol
Aylık 10.000 krediyle başlayın ve yalnızca kullanım arttığında yükseltin.
Aktif
Örnek İstek
curl ve HTTP örneklerinden başlayın, sonra parametreleri uygulama kodunuza eşleyin.
Temel Özellikler
Yalnızca önbellek sorgulaması
Yalnızca önbelleğe alınmış verileri sunmak için prefer_cache=1 kullanın. Eksik sonuç 202 döndürür, yenilemeyi kuyruğa alır ve istek kredilerini iade eder.
Pasif toplama
DomScan etiketleri kaba kuvvetle denemez, bağlantı noktalarını taramaz ve hedef siteyi dolaşmaz.
Varlık Keşfi
Unutulmuş veya gölge BT olabilecek ana bilgisayar adlarına ilişkin genel kanıtları inceleyin.
Güvenlik Değerlendirmesi
Döndürülen ana bilgisayar adı kanıtlarını yetkili bir güvenlik incelemesinin girdilerinden biri olarak kullanın.
Sertifika tarihi kanıtı
CT destekli girdiler bulunan en erken sertifika not-before değerini bildirir. Pasif yedek girdiler null döndürebilir.
Açık yeniden deneme davranışı
Yalnızca önbellek isteklerindeki eksik sonuçlar Retry-After ile 202 döndürür. Eski önbellek olmadan tüm kaynaklar başarısız olursa 503 döner. Her iki yanıt da kredileri iade eder.
Yapılandırılmış API çıktısı
JSON içindeki source, first_seen, verification, wildcard, cache ve coverage alanlarını inceleyin.
Örnek İstek
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/subdomains?domain=example.com&sources=ct&verify=yes&include_wildcards=yes"Örnek Yanıt
{
"domain": "example.com",
"subdomains": [
{
"name": "api.example.com",
"source": "crtsh",
"first_seen": "2026-01-18T09:24:00Z",
"verified": true,
"dns_records": {
"A": ["192.0.2.10"],
"CNAME": null
}
}
],
"wildcards": [
{
"pattern": "*.example.com",
"source": "crtsh",
"first_seen": "2025-11-04T14:10: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": 500,
"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": "2026-01-18T09:24:00Z",
"first_seen_newest": "2026-01-18T09:24:00Z",
"warning_count": 0
},
"meta": {
"query_time_ms": 842,
"cached": false
}
}Sıkça Sorulan Sorular
Bu yasal mı?
Endpoint genel veri kümelerini okur ve istendiğinde yalnızca önceden bulduğu adlar için DNS sorguları gönderir. Etiketleri kaba kuvvetle denemez, bağlantı noktalarını taramaz ve hedef siteleri dolaşmaz. Sonuçları yetkiniz ve yerel yasalar kapsamında kullanmak sizin sorumluluğunuzdadır.
Keşif ne kadar kapsamlı?
Hayır. Her pasif kaynakta boşluklar vardır. Dahili adlar, kaynak veri kümelerinde bulunmayan ana bilgisayarlar ve genel sertifikalarda veya arşivlerde hiç görünmemiş adlar eksik olabilir. Yanıtı eksiksiz bir envanter değil, kanıt olarak değerlendirin.
202 yanıtı ne anlama gelir?
202, yalnızca önbellek isteği için hazır yeni veya eski sonuç olmadığı anlamına gelir. DomScan arka plan yenilemesini kuyruğa aldı, Retry-After döndürdü ve istek kredilerini iade etti.
Bu işlem güvenlik açıklarını bulabilir mi?
Hayır. Endpoint ana bilgisayar adı kanıtı ve isteğe bağlı DNS çözümlemesi döndürür. Döndürülen ana bilgisayarları güvenlik açıklarına karşı test etmez.
İlgili Araçlar ve Kaynaklar
HTTP Durum Kodları
Başarılı yanıtları, kimlik doğrulama sorunlarını, kredileri, hız sınırlarını, eksik verileri ve yukarı akış hatalarını ayırt edebilmeniz için istemcinizin işlemesi gereken HTTP durum kodlarını belgeliyoruz.
OK
200
İstek başarılı
Kabul edildi
202
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.
Hatalı İstek
400
Geçersiz parametreler
Yetkisiz
401
API anahtarı veya oturum eksik ya da geçersiz.
Ödeme Gerekli
402
Bu isteği çalıştırmak için yeterli krediniz yok.
Çok Fazla İstek
429
Hız sınırı aşıldı
Hizmet Kullanılamıyor
503
Yukarı akış hizmeti kullanılamıyor veya geçici olarak hız sınırı uyguluyor.
Ağ Geçidi Zaman Aşımı
504
Yukarı akış sorgusu zaman aşımına uğradı.
Alt Alan Adlarını Keşfet