Voor wie is dit?
Gebruik gerichte controles voor één beslissing of stel een breder profiel samen wanneer context belangrijk is.
Wat je krijgt
Plaats meerdere ondersteunde API-verzoeken in de wachtrij en verzamel de resultaten zonder een clientverbinding open te houden.
AsynchroonRESTMCPSDK
Kies dit product wanneer
Kies dit product wanneer
Kies dit om combinaties uit een Engelstalig corpus met enkelvoudige woorden te controleren over 1 tot 5 TLD’s, met maximaal 100 woord- en TLD-controles per job.
Wat je krijgt
Plaats meerdere ondersteunde API-verzoeken in de wachtrij en verzamel de resultaten zonder een clientverbinding open te houden.
Endpoints
Bekijk vóór de integratie de ondersteunde bewerkingen, invoer, uitvoer, uitvoeringsmodi en responslimieten.
Credits en authenticatie
1 Authenticatie vereist. Bekijk de bewerkingsreferentie voor de exacte kosten en eventuele prijs per item.
Voorbeeldbewerking
Gebruik gedocumenteerde bewerkingen om openbaar bewijs te verzamelen, te beoordelen, te verrijken, te verifiëren, te vergelijken, te beschermen of te monitoren.
POST
/v1/domain-discovery/jobs
Lichaamsparameters
| Parameter | Type | vereist |
|---|---|---|
| tlds | string[] | vereist |
| limit | integer | optioneel |
| cursor | string | optioneel |
| min_length |
integer
Standaard
3
|
optioneel |
| max_length |
integer
Standaard
16
|
optioneel |
| singular_only |
boolean
Standaard
false
|
optioneel |
Antwoordvelden
| Veld | Type |
|---|---|
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 |
Voorbeeldverzoek
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
}'Voorbeeldantwoord
{
"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"
}
}Beperkingen en grenzen van het bewijs
Asynchrone jobs geven een identifier terug voor statuspolling en het later ophalen van resultaten.
Bulkbewerkingen verwerken meerdere ondersteunde inputs en behouden de gedocumenteerde resultaten per item.
Gedeeltelijk betekent dat sommige gevraagde items of onderdelen zijn voltooid en andere niet.
De dekking wordt begrensd door de gedocumenteerde inputs, budgetten, bronnen en responslimieten.
Een afwezig of onbekend resultaat bewijst niet dat een identifier kan worden geclaimd of geregistreerd.
Beoordeeld op 2026-08-22
Veelgestelde vragen
Waar vind ik de request- en response-referentie voor Domeinzoekrecept?
Gebruik de API-referentie voor Domeinzoekrecept om parameters, responsevelden, voorbeelden, statuscodes en ondersteunde uitvoeringsmodi te bekijken.
Hoe moet ik onbekende of onvolledige resultaten van Domeinzoekrecept interpreteren?
Onbekende of gedeeltelijke resultaten betekenen dat het gevraagde bewijs niet volledig kon worden vastgesteld. Houd de resultaatstatus, betrouwbaarheid, actualiteit en beperkingen bij in vervolgbeslissingen.
Hoe wordt Domeinzoekrecept geprijsd?
De prijs hangt af van de bewerking en uitvoeringsmodus. Bekijk de endpointreferentie voor de actuele creditkosten, authenticatievereiste en regels per item.
