A chi è rivolto
Usa controlli focalizzati per una singola decisione oppure crea un profilo più ampio quando il contesto è importante.
Cosa ottieni
Accoda più richieste API supportate e raccogli i risultati senza mantenere aperta una connessione client.
AsincronaRESTMCPSDK
Scegli questo prodotto quando
Scegli questo prodotto quando
Sceglilo per controllare combinazioni da un corpus inglese di parole singole tra 1 e 5 TLD, con fino a 100 controlli di parole e TLD per job.
Cosa ottieni
Accoda più richieste API supportate e raccogli i risultati senza mantenere aperta una connessione client.
Endpoint
Esamina le operazioni, gli input, gli output, le modalità di esecuzione e i limiti di risposta supportati prima dell’integrazione.
Crediti e autenticazione
1 Autenticazione richiesta. Consulta il riferimento dell’operazione per il costo esatto e gli eventuali prezzi per elemento.
Operazione di esempio
Usa operazioni documentate per raccogliere, valutare, arricchire, verificare, confrontare, proteggere o monitorare prove pubbliche.
POST
/v1/domain-discovery/jobs
Parametri del corpo
| Parametro | Tipo | obbligatorio |
|---|---|---|
| tlds | string[] | obbligatorio |
| limit | integer | facoltativo |
| cursor | string | facoltativo |
| min_length |
integer
Predefinito
3
|
facoltativo |
| max_length |
integer
Predefinito
16
|
facoltativo |
| singular_only |
boolean
Predefinito
false
|
facoltativo |
Campi di risposta
| Campo | Tipo |
|---|---|
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 |
Richiesta di esempio
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
}'Risposta di esempio
{
"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"
}
}Limiti e confini delle prove
I job asincroni restituiscono un identificatore per interrogare lo stato e recuperare in seguito i risultati.
Le operazioni bulk elaborano più input supportati mantenendo gli esiti documentati per ogni elemento.
Parziale significa che alcuni elementi o componenti richiesti sono stati completati e altri no.
La copertura è limitata dagli input, dai budget, dalle fonti e dai limiti di risposta documentati.
Un risultato assente o sconosciuto non dimostra che un identificatore possa essere rivendicato o registrato.
Verificato il 2026-08-22
Domande frequenti
Dove posso trovare il riferimento di richiesta e risposta di Workflow per trovare domini?
Usa il riferimento API di Workflow per trovare domini per esaminare parametri, campi di risposta, esempi, codici di stato e modalità operative supportate.
Come devo interpretare i risultati sconosciuti o incompleti di Workflow per trovare domini?
I risultati sconosciuti o parziali indicano che le prove richieste non hanno potuto essere determinate completamente. Conserva stato del risultato, confidenza, aggiornamento e limiti nelle decisioni successive.
Come viene tariffato Workflow per trovare domini?
Il prezzo dipende dall’operazione e dalla modalità di esecuzione. Consulta il riferimento dell’endpoint per il costo attuale in crediti, il requisito di autenticazione e le regole per elemento.
