Für wen es gedacht ist
Nutzen Sie fokussierte Prüfungen für eine einzelne Entscheidung oder erstellen Sie bei Bedarf ein umfassenderes Profil.
Was Sie erhalten
Stellen Sie mehrere unterstützte API-Anfragen in eine Warteschlange und rufen Sie die Ergebnisse ab, ohne eine Clientverbindung offen zu halten.
AsynchronRESTMCPSDK
Wählen Sie dieses Produkt, wenn
Wählen Sie dieses Produkt, wenn
Wählen Sie dies, um Kombinationen aus einem englischen Einzelwortkorpus über 1 bis 5 TLDs zu prüfen, mit bis zu 100 Wort- und TLD-Prüfungen pro Job.
Was Sie erhalten
Stellen Sie mehrere unterstützte API-Anfragen in eine Warteschlange und rufen Sie die Ergebnisse ab, ohne eine Clientverbindung offen zu halten.
Endpunkte
Prüfen Sie vor der Integration die unterstützten Operationen, Eingaben, Ausgaben, Ausführungsmodi und Antwortlimits.
Credits und Authentifizierung
1 Authentifizierung erforderlich. Die genaue Gebühr und mögliche Preise pro Element finden Sie in der Operationsreferenz.
Beispieloperation
Nutzen Sie dokumentierte Operationen, um öffentliche Belege zu erfassen, zu bewerten, anzureichern, zu verifizieren, zu vergleichen, zu schützen oder zu überwachen.
POST
/v1/domain-discovery/jobs
Body-Parameter
| Parameter | Typ | erforderlich |
|---|---|---|
| tlds | string[] | erforderlich |
| limit | integer | optional |
| cursor | string | optional |
| min_length |
integer
Standard
3
|
optional |
| max_length |
integer
Standard
16
|
optional |
| singular_only |
boolean
Standard
false
|
optional |
Antwort-Felder
| Feld | Typ |
|---|---|
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 |
Beispielanfrage
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
}'Beispielantwort
{
"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"
}
}Limits und Grenzen der Beweislage
Asynchrone Jobs liefern eine Kennung für Statusabfragen und den späteren Abruf der Ergebnisse.
Bulk-Operationen verarbeiten mehrere unterstützte Eingaben und bewahren die dokumentierten Ergebnisse pro Element.
Teilweise bedeutet, dass einige angeforderte Elemente oder Komponenten abgeschlossen wurden und andere nicht.
Die Abdeckung ist durch die dokumentierten Eingaben, Budgets, Quellen und Antwortlimits begrenzt.
Ein fehlendes oder unbekanntes Ergebnis beweist nicht, dass eine Kennung beansprucht oder registriert werden kann.
Geprüft am 2026-08-22
Häufig gestellte Fragen
Wo finde ich die Request- und Response-Referenz für Domain-Finder Rezept?
In der API-Referenz für Domain-Finder Rezept finden Sie Parameter, Response-Felder, Beispiele, Statuscodes und unterstützte Operationsmodi.
Wie sollte ich unbekannte oder unvollständige Ergebnisse von Domain-Finder Rezept interpretieren?
Unbekannte oder teilweise Ergebnisse bedeuten, dass die angeforderten Belege nicht vollständig bestimmt werden konnten. Berücksichtigen Sie Ergebnisstatus, Konfidenz, Aktualität und Einschränkungen in nachgelagerten Entscheidungen.
Wie wird Domain-Finder Rezept abgerechnet?
Die Abrechnung hängt von Operation und Ausführungsmodus ab. Die Endpoint-Referenz nennt die aktuellen Credit-Kosten, die Authentifizierungsanforderung und die Regeln pro Element.
