Alan Adı Bulucu Tarifi API'si

Q: Hangi uç noktalar dahil?

Bu kılavuz 4 genel uç noktayı kapsar: POST /v1/domain-discovery/jobs , GET /v1/batches/:job_id , GET /v1/batches/:job_id/results , DELETE /v1/batches/:job_id .

curl -X POST "https://domscan.net/v1/domain-discovery/jobs" \ -H "X-API-Key: $DOMSCAN_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: discovery-com-io-1" \ -d '{"tlds":["com","io"],"limit":25,"min_length":4,"max_length":12,"singular_only":true}'

{ "job": { "id": "bat_...", "status": "queued", "total": 50, "status_url": "https://domscan.net/v1/batches/bat_...", "results_url": "https://domscan.net/v1/batches/bat_.../results" }, "discovery": { "page_words": 25, "tlds": ["com", "io"], "domain_checks": 50, "credits_per_domain": 1, "next_cursor": "..." } }

Kategori Alan Adı İstihbaratı

Uç Noktalar 4

Kredi 0-1/item

Kimlik Doğrulama Kimlik dogrulama gerekli

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.

Canlı Hizmet durumu

Entegrasyondan önce canlı hizmet durumunu ve belgelenmiş hata yanıtlarını kontrol edin.

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ı.

Ürün workflow’ları

Domain kontrollerini, DNS istihbaratını, risk sinyallerini veya zenginleştirmeyi onboarding, arama ve dahili araçlara gömün.

Analist otomasyonu

Tekrarlanan manuel sorguları planlı işler, uyarılar ve yeniden üretilebilir araştırma adımlarıyla değiştirin.

Temiz JSON verisi

Sağlayıcı sayfalarını kazımak yerine öngörülebilir alanlar, belgelenmiş durum kodları ve kredi maliyetleri kullanın.

AI ve ops araçları

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 koleksiyonu

Manuel test ve ekip devri için hazır istekleri içe aktarın.

SDK’ler ve CLI

Boilerplate yazmak yerine bakımı yapılan paketleri ve komut satırı workflow’larını kullanın.

MCP entegrasyonu

Domain 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.

İstek parametreleri

Parametre

tldslimitcursormin_lengthmax_lengthsingular_onlyjob_idafterformat

Yanıt alanları

Örnek Yanıt

jobjob.idjob.statusjob.totaljob.status_urljob.results_urldiscoverydiscovery.page_wordsdiscovery.tldsdiscovery.domain_checksdiscovery.credits_per_domaindiscovery.next_cursor

Durum kapsamı

HTTP Durum Kodları

200202400401402409429

Uç Noktalar

POST /v1/domain-discovery/jobs

Kredi: 1/itemKimlik Doğrulama: Kimlik dogrulama gerekli

tldslimitcursormin_lengthmax_lengthsingular_only

GET /v1/batches/:job_id

Kredi: 0Kimlik Doğrulama: Kimlik dogrulama gerekli

job_id

GET /v1/batches/:job_id/results

Kredi: 0Kimlik Doğrulama: Kimlik dogrulama gerekli

job_idafterlimitformat

DELETE /v1/batches/:job_id

Kredi: 0Kimlik Doğrulama: Kimlik dogrulama gerekli

job_id

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

Uç Noktalar

POST /v1/domain-discovery/jobs • GET /v1/batches/:job_id • GET /v1/batches/:job_id/results • DELETE /v1/batches/:job_id

Parametre

tlds, limit, cursor, min_length, max_length, singular_only, job_id, after, format

HTTP Durum Kodları

200, 202, 400, 401, 402, 409, 429

Kredi / Kimlik Doğrulama

0-1/item / Kimlik dogrulama gerekli

Örnek İstek

POST /v1/domain-discovery/jobs bash

curl -X POST "https://domscan.net/v1/domain-discovery/jobs" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: discovery-com-io-1" \
  -d '{"tlds":["com","io"],"limit":25,"min_length":4,"max_length":12,"singular_only":true}'

Örnek Yanıt

202 Accepted json

{
  "job": {
    "id": "bat_...",
    "status": "queued",
    "total": 50,
    "status_url": "https://domscan.net/v1/batches/bat_...",
    "results_url": "https://domscan.net/v1/batches/bat_.../results"
  },
  "discovery": {
    "page_words": 25,
    "tlds": ["com", "io"],
    "domain_checks": 50,
    "credits_per_domain": 1,
    "next_cursor": "..."
  }
}

Sıkça Sorulan Sorular

Hangi uç noktalar dahil?

Bu kılavuz 4 genel uç noktayı kapsar: POST /v1/domain-discovery/jobs, GET /v1/batches/:job_id, GET /v1/batches/:job_id/results, DELETE /v1/batches/:job_id.

Bu API kimlik doğrulama gerektiriyor mu?

Evet. Alan Adı Bulucu Tarifi çağrılırken API anahtarınızı `X-API-Key` veya `Authorization: Bearer` başlığıyla gönderin.

Kaç kredi kullanıyor?

Bu kılavuzlardaki istekler, uç noktaya bağlı olarak 0-1/item kredi kullanır. Toplu uç noktalarda krediler standart öğe başı oranla uygulanır.

Tam parametreleri ve ilgili uç noktaları nerede görebilirim?

Alan Adı Bulucu Tarifi için tam dokümanı kullanarak parametre ayrıntılarını, kimlik doğrulama notlarını ve aynı API ailesindeki ilgili uç noktaları inceleyin.

İ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.

HTTP 409 409

Çok Fazla İstek 429

Hız sınırı aşıldı

Aylık 10.000 krediyle ücretsiz başlayın. Herkese açık API’lerden herhangi birini kullanın ve yalnızca gerektiğinde kredi ekleyin.

Ücretsiz Başlayın Dokümantasyonu görüntüle