Entegrasyondan önce canlı hizmet durumunu ve belgelenmiş hata yanıtlarını kontrol edin.
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, Swagger, Postman, CLI, SDK ve MCP bağlantıları bir tık uzakta.
Kimliği doğrulanmış endpointler, çağrıdan önce net kredi maliyetleriyle API anahtarları kullanır.
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.
API anahtarınızı belgelenmiş header ile gönderin ve servisler arasında istekleri tutarlı tutun.
curl ve HTTP örneklerinden başlayın, sonra parametreleri uygulama kodunuza eşleyin.
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.
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
Örnek Yanıt
HTTP Durum Kodları
Uç Noktalar
/v1/scrape
/v1/scrape/jobs
/v1/scrape/jobs/:job_id
/v1/scrape/jobs/:job_id/results
Her URL için alma düzeyini seçin
Krediler, hedef web sitesinin döndürdüğü HTTP durumuna veya içeriğe değil, istediğiniz moda göre belirlenir.
Standart
URL başına 1 kredi
Basit sayfalar için tek bir standart alma denemesidir.
Dayanıklı
URL başına 2 kredi
Sonuç belgelenen yeniden deneme koşullarını karşılıyorsa bir standart deneme ve bir yeniden denemedir.
Oluşturulmuş
URL başına 10 kredi
JavaScript çalıştırılması gereken sayfalar için tarayıcıda oluşturulan tek bir denemedir.
Dayanıklı oluşturulmuş
URL başına 20 kredi
Sonuç belgelenen yeniden deneme koşullarını karşılıyorsa tarayıcıda oluşturulan bir deneme ve bir yeniden denemedir.
Dayanıklı modlar, ilk deneme başarılı olsa bile listelenen tutara mal olur. Bir uygun yeniden denemeyi içerir; sınırsız yeniden denemeyi veya hedef sitenin beklediğiniz içeriği döndüreceğine dair garantiyi içermez.
Faturalandırma istenen çalışmayı yansıtır
Başarılı bir API işlemi, DomScan'in seçilen alma modunu uygulayıp hedefin döndürdüğü sonucu verdiği anlamına gelir.
Sonuç yine de bir yönlendirme, HTTP hatası, engellenmiş yanıt, doğrulama sayfası, boş sayfa veya ihtiyaçlarınızı karşılamayan içerik olabilir. Bu hedef site sonuçları ücretlendirilir ve kredi iadesine uygun değildir.
İade yalnızca DomScan kendi platformunun seçilen alma modunu uygulayamadığını doğruladığında yapılabilir.
Tarayıcıda oluşturma bir sayfanın başarıyla yükleneceğini garanti etmez; dayanıklı modlar da yeniden denemenin farklı bir sonuç üreteceğini garanti etmez.
Scrape API'ye özel kullanım sınırları
Bu sınırlar özellikle Scrape API için geçerlidir. Diğer hesap ve platform korumaları da uygulanabilir.
| Yetenek | Ücretsiz hesaplar | Ücretli hesaplar |
|---|---|---|
| Kullanılabilir modlar | Yalnızca standart | Dört modun tamamı |
| İstek hızı | Dakikada 5 istek | Dakikada 60 istek |
| Eşzamanlı standart veya dayanıklı istekler | 1 standart istek | 5 istek |
| Eşzamanlı oluşturulmuş istekler | Kullanılamaz | 2 istek |
| Günlük kota | 100 istek | Kullanılabilir kredilere ve hız sınırlarına göre |
| Aylık kota | 500 istek | Kullanılabilir kredilere ve hız sınırlarına göre |
| Döndürülen en fazla içerik | İstek başına 256 KiB | İstek başına 512 KiB |
| Eşzamansız toplu işler | Kullanılamaz | Kullanılabilir |
Bir yanıt geçerli içerik sınırını aşarsa API izin verilen bölümü döndürür ve yanıtı kesilmiş olarak işaretler.
Eşzamansız olarak 100 URL'ye kadar işleyin
Ücretli hesaplar 100 URL'ye kadar içeren bir eşzamansız iş gönderebilir.
Dakikada en fazla 5 yeni toplu iş
Hesap başına en fazla 3 etkin iş
Hesap başına sırada en fazla 300 URL öğesi
Tek işte en fazla 100 URL
Tamamlanan sonuçlar 24 saat kullanılabilir
İş meta verileri 7 gün saklanır
Her URL, seçilen modu kullanarak ayrı ayrı ücretlendirilir.
Tamamlanan sonuçları 24 saat içinde indirin veya kopyalayın. Bu süreden sonra sınırlı iş meta verileri 7 gün kullanılabilir kalsa da yanıt içeriği kaldırılır.
Gizli yükseltme seçenekleri olmadan net kapsam
CAPTCHA çözme yoktur
Tarayıcıda oluşturma sayfa JavaScript'ini çalıştırabilir; ancak Scrape API CAPTCHA çözmez, oturum açma gerekliliklerini, ücretli erişimi, erişim denetimlerini veya diğer kısıtlamaları aşmaz. Hedefin döndürdüğü CAPTCHA ya da doğrulama sayfası hedef site sonucudur ve iade edilmez.
Premium proxy seçimi yoktur
Alma modunu ve çaba düzeyini siz seçersiniz. Premium proxy, sağlayıcı, havuz veya ülke seçimi parametresi yoktur.
Kabul edilebilir kullanım
Scrape API'yi yalnızca yasal olarak erişmenize ve işlemenize izin verilen içerik için kullanın. Yürürlükteki yasalara, hedef site koşullarına, gizlilik yükümlülüklerine ve gerekli izinlere uymak sizin sorumluluğunuzdadır.
API'yi kimlik doğrulamayı, ücretli erişimi, CAPTCHA'ları veya erişim denetimlerini aşmak ya da kimlik bilgisi saldırıları, hesap kötüye kullanımı, taciz, yasa dışı gözetim veya kişisel verilerin yasa dışı toplanması için kullanmayın. Kullanım kişileri, hizmetleri veya platformu tehdit ederse DomScan istekleri reddedebilir veya erişimi askıya alabilir.
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, Swagger, Postman, CLI, SDK ve MCP bağlantıları bir tık uzakta.
Kimliği doğrulanmış endpointler, çağrıdan önce net kredi maliyetleriyle API anahtarları kullanır.
Aylık 10.000 krediyle başlayın ve yalnızca kullanım arttığında yükseltin.
curl ve HTTP örneklerinden başlayın, sonra parametreleri uygulama kodunuza eşleyin.
Temel Özellikler
Krediler, hedef web sitesinin döndürdüğü HTTP durumuna veya içeriğe değil, istediğiniz moda göre belirlenir.
Başarılı bir API işlemi, DomScan'in seçilen alma modunu uygulayıp hedefin döndürdüğü sonucu verdiği anlamına gelir.
Ücretli hesaplar 100 URL'ye kadar içeren bir eşzamansız iş gönderebilir.
Bu sınırlar özellikle Scrape API için geçerlidir. Diğer hesap ve platform korumaları da uygulanabilir.
Tarayıcıda oluşturma sayfa JavaScript'ini çalıştırabilir; ancak Scrape API CAPTCHA çözmez, oturum açma gerekliliklerini, ücretli erişimi, erişim denetimlerini veya diğer kısıtlamaları aşmaz. Hedefin döndürdüğü CAPTCHA ya da doğrulama sayfası hedef site sonucudur ve iade edilmez.
Scrape API'yi yalnızca yasal olarak erişmenize ve işlemenize izin verilen içerik için kullanın. Yürürlükteki yasalara, hedef site koşullarına, gizlilik yükümlülüklerine ve gerekli izinlere uymak sizin sorumluluğunuzdadır.
Örnek İstek
curl -X POST "https://domscan.net/v1/scrape" \
-H "X-API-Key: $DOMSCAN_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com/","mode":"standard","output":"markdown"}'
curl -X POST "https://domscan.net/v1/scrape" \
-H "X-API-Key: $DOMSCAN_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com/app","mode":"rendered","output":"html"}'
curl -X POST "https://domscan.net/v1/scrape/jobs" \
-H "X-API-Key: $DOMSCAN_API_KEY" \
-H "Idempotency-Key: docs-batch-1" \
-H "Content-Type: application/json" \
-d '{"mode":"standard","output":"text","urls":["https://example.com/page-1","https://example.com/page-2"]}'
Örnek Yanıt
{
"data": {
"url": "https://example.com/",
"final_url": "https://example.com/",
"status": 200,
"outcome": "success",
"content_type": "text/html",
"content": "<!doctype html>...",
"bytes": 1256,
"truncated": false,
"redirect_count": 0,
"attempt_count": 1,
"duration_ms": 428,
"fetched_at": "2026-08-20T10:30:00.000Z",
"headers": { "cache-control": "max-age=604800" },
"rendered": false
},
"billing": {
"credits_charged": 1,
"credits_refunded": 0,
"policy": "effort_based"
}
}
Sıkça Sorulan Sorular
Seçilen moda göre bir URL 1, 2, 10 veya 20 krediye mal olur. Toplu iş öğeleri aynı URL başına fiyatlandırmayı kullanır.
Evet. Yönlendirmeler, HTTP hataları, engellemeler, doğrulama sayfaları, boş sayfalar veya beklenmeyen içerik gibi hedef yanıtları ücretlendirilir; çünkü DomScan istenen alma çalışmasını yine de gerçekleştirmiştir.
İade yalnızca DomScan kendi platformunun seçilen alma modunu uygulayamadığını doğruladığında yapılabilir. Hedef sitenin davranışı platform arızası değildir.
Hayır. Dayanıklı mod, ilk sonuç belgelenen yeniden deneme koşullarını karşılıyorsa bir yeniden deneme içerir.
Hayır. Sayfa JavaScript'ini çalıştırır ancak CAPTCHA çözmez veya erişim kısıtlamalarını aşmaz.
Hayır. API proxy katmanlarını, sağlayıcıları, havuzları veya ülke hedeflemesini sunmaz. Yalnızca alma modunu seçersiniz.
Hayır. Eşzamansız toplu işler yalnızca ücretli hesaplara açıktır. Ücretsiz hesaplar yayımlanan ücretsiz sınırlar içinde standart modu kullanabilir.
Tamamlanan yanıt içeriği 24 saat kullanılabilir. Sınırlı iş meta verileri 7 gün kullanılabilir kalır.
İ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.
İstek başarılı
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.
Geçersiz parametreler
API anahtarı veya oturum eksik ya da geçersiz.
Bu isteği çalıştırmak için yeterli krediniz yok.
Kimlik doğrulandı, ancak bu işlem veya modu kullanma izniniz yok.
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.
Hız sınırı aşıldı
Yukarı akış hizmeti kullanılamıyor veya geçici olarak hız sınırı uyguluyor.
API anahtarı alın