Kimler için
Tek bir karar için odaklı kontroller kullanın veya bağlam önemli olduğunda daha geniş bir profil oluşturun.
Elde edecekleriniz
İstemci bağlantısını açık tutmadan birçok desteklenen API isteğini kuyruğa alın ve sonuçlarını toplayın.
AsenkronRESTMCPSDK
Bu ürünü şu durumlarda seçin
Bu ürünü şu durumlarda seçin
1 ile 5 TLD arasında İngilizce tek sözcük derleminden kombinasyonları kontrol etmek için seçin, görev başına en fazla 100 sözcük ve TLD kontrolü.
Elde edecekleriniz
İstemci bağlantısını açık tutmadan birçok desteklenen API isteğini kuyruğa alın ve sonuçlarını toplayın.
Uç noktalar
Entegrasyondan önce desteklenen işlemleri, girdileri, çıktıları, yürütme modlarını ve yanıt sınırlarını inceleyin.
Krediler ve kimlik doğrulama
1 Kimlik doğrulama gerekli. Kesin maliyet ve öğe başına fiyatlandırma kuralları için işlem referansına bakın.
İşlem örneği
Herkese açık kanıtları toplamak, değerlendirmek, zenginleştirmek, doğrulamak, karşılaştırmak, korumak veya izlemek için belgelenmiş işlemleri kullanın.
POST
/v1/domain-discovery/jobs
Gövde Parametreleri
| Parametre | Tür | gerekli |
|---|---|---|
| tlds | string[] | gerekli |
| limit | integer | isteğe bağlı |
| cursor | string | isteğe bağlı |
| min_length |
integer
Varsayılan
3
|
isteğe bağlı |
| max_length |
integer
Varsayılan
16
|
isteğe bağlı |
| singular_only |
boolean
Varsayılan
false
|
isteğe bağlı |
Yanıt Alanları
| Alan | Tür |
|---|---|
job |
object |
job.id |
string |
job.status |
string |
job.total |
integer |
job.counts |
object |
job.counts.pending |
integer |
job.counts.processing |
integer |
job.counts.succeeded |
integer |
job.counts.failed |
integer |
job.counts.cancelled |
integer |
job.billing |
object |
job.billing.credits_charged |
integer |
job.billing.credits_refunded |
integer |
job.billing.credits_net |
integer |
job.webhook |
object |
job.webhook.configured |
boolean |
job.webhook.status |
string |
job.webhook.attempts |
integer |
job.status_url |
string |
job.results_url |
string |
job.results_csv_url |
string |
job.poll_after_ms |
integer | null |
job.created_at |
string |
job.started_at |
string | null |
job.completed_at |
string | null |
job.cancelled_at |
string | null |
job.updated_at |
string |
job.processing_deadline_at |
string |
job.results_expires_at |
string |
discovery |
object |
discovery.corpus |
string |
discovery.corpus_version |
string |
discovery.total_matching_words |
integer |
discovery.page_offset |
integer |
discovery.page_words |
integer |
discovery.domain_checks |
integer |
discovery.tlds[] |
string[] |
discovery.filters |
object |
discovery.filters.min_length |
integer |
discovery.filters.max_length |
integer |
discovery.filters.singular_only |
boolean |
discovery.credits_per_domain |
integer |
discovery.next_cursor |
string | null |
Örnek İstek
curl -X POST "https://domscan.net/v1/domain-discovery/jobs" \
-H "Content-Type: application/json" \
-H "X-API-Key: $DOMSCAN_API_KEY" \
-d '{
"tlds": [
"io",
"ai"
],
"limit": 50,
"min_length": 4,
"max_length": 8,
"singular_only": true
}'Örnek Yanıt
{
"job": {
"id": "example-id",
"status": "queued",
"total": 1,
"counts": {
"pending": 1,
"processing": 1,
"succeeded": 1,
"failed": 1,
"cancelled": 1
},
"billing": {
"credits_charged": 1,
"credits_refunded": 1,
"credits_net": 1
},
"webhook": {
"configured": false,
"status": "not_configured",
"attempts": 1
},
"status_url": "https://example.com",
"results_url": "https://example.com",
"results_csv_url": "https://example.com",
"created_at": "2026-08-27T12:00:00Z",
"updated_at": "2026-08-27T12:00:00Z",
"processing_deadline_at": "2026-08-27T12:00:00Z",
"results_expires_at": "2026-08-27T12:00:00Z",
"poll_after_ms": 1,
"started_at": "2026-08-27T12:00:00Z",
"completed_at": "2026-08-27T12:00:00Z",
"cancelled_at": "2026-08-27T12:00:00Z"
},
"discovery": {
"corpus": "iannuttall/unclaimed",
"corpus_version": "example",
"total_matching_words": 1,
"page_offset": 1,
"page_words": 1,
"domain_checks": 1,
"tlds": [
"com",
"net",
"org"
],
"filters": {
"min_length": 1,
"max_length": 1,
"singular_only": false
},
"credits_per_domain": 1,
"next_cursor": "example"
}
}Sınırlar ve kanıt kapsamı
Asenkron işler, durumu sorgulamak ve sonuçları daha sonra almak için bir tanımlayıcı döndürür.
Toplu işlemler birden çok desteklenen girdiyi işler ve belgelenen öğe düzeyi sonuçlarını korur.
Kısmi, istenen öğelerin veya bileşenlerin yalnızca bir bölümünün tamamlandığı anlamına gelir.
Kapsam, belgelenen girdiler, bütçeler, kaynaklar ve yanıt sınırlarıyla sınırlıdır.
Yokluk veya bilinmeyen sonucu, bir tanımlayıcının alınabileceğini veya kaydedilebileceğini kanıtlamaz.
2026-08-22 tarihinde incelendi
Sık sorulan sorular
Alan Adı Bulucu Tarifi istek ve yanıt referansını nerede bulabilirim?
Parametreleri, yanıt alanlarını, örnekleri, durum kodlarını ve desteklenen yürütme modlarını incelemek için Alan Adı Bulucu Tarifi API referansını kullanın.
Alan Adı Bulucu Tarifi kaynaklı bilinmeyen veya eksik sonuçları nasıl yorumlamalıyım?
Bilinmeyen veya kısmi sonuçlar, istenen kanıtın tamamen belirlenemediği anlamına gelir. Sonraki kararlarda sonuç durumunu, güveni, güncelliği ve sınırları koruyun.
Alan Adı Bulucu Tarifi nasıl fiyatlandırılır?
Fiyatlandırma işleme ve yürütme moduna bağlıdır. Güncel kredi maliyeti, kimlik doğrulama gereksinimi ve öğe başına kurallar için uç nokta referansına bakın.
