À qui s’adresse ce produit
Utilisez des contrôles ciblés pour une décision précise ou composez un profil plus large lorsque le contexte compte.
Ce que vous obtenez
Placez plusieurs requêtes API compatibles en file d’attente et récupérez leurs résultats sans maintenir une connexion cliente ouverte.
AsynchroneRESTMCPSDK
Choisissez ce produit lorsque
Choisissez ce produit lorsque
À choisir pour vérifier des combinaisons issues d’un corpus anglais de mots uniques sur 1 à 5 TLD, avec jusqu’à 100 contrôles de mots et de TLD par tâche.
Ce que vous obtenez
Placez plusieurs requêtes API compatibles en file d’attente et récupérez leurs résultats sans maintenir une connexion cliente ouverte.
Endpoints
Examinez les opérations, entrées, sorties, modes d’exécution et limites de réponse pris en charge avant l’intégration.
Crédits et authentification
1 Authentification requise. Consultez la référence de l’opération pour connaître le coût exact et les éventuels tarifs par élément.
Opération exemple
Utilisez des opérations documentées pour collecter, évaluer, enrichir, vérifier, comparer, protéger ou surveiller des preuves publiques.
POST
/v1/domain-discovery/jobs
Paramètres du Corps
| Paramètre | Type | requis |
|---|---|---|
| tlds | string[] | requis |
| limit | integer | optionnel |
| cursor | string | optionnel |
| min_length |
integer
Défaut
3
|
optionnel |
| max_length |
integer
Défaut
16
|
optionnel |
| singular_only |
boolean
Défaut
false
|
optionnel |
Champs de Réponse
| Champ | 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 |
Exemple de Requête
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
}'Exemple de Réponse
{
"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"
}
}Limites et périmètre des preuves
Les tâches asynchrones renvoient un identifiant pour interroger leur état et récupérer ensuite les résultats.
Les opérations en lot traitent plusieurs entrées prises en charge tout en conservant les résultats documentés pour chaque élément.
Partiel signifie que certains éléments ou composants demandés ont abouti et que d’autres n’ont pas abouti.
La couverture est limitée par les entrées, budgets, sources et limites de réponse documentés.
Un résultat absent ou inconnu ne prouve pas qu’un identifiant peut être revendiqué ou enregistré.
Vérifié le 2026-08-22
Questions fréquentes
Où trouver la référence des requêtes et réponses de Recette de Chercheur de Domaines ?
Utilisez la référence API de Recette de Chercheur de Domaines pour consulter les paramètres, les champs de réponse, les exemples, les codes d’état et les modes d’opération pris en charge.
Comment interpréter les résultats inconnus ou incomplets de Recette de Chercheur de Domaines ?
Les résultats inconnus ou partiels signifient que les preuves demandées n’ont pas pu être déterminées entièrement. Conservez l’état du résultat, le niveau de confiance, la fraîcheur et les limites dans vos décisions en aval.
Comment Recette de Chercheur de Domaines est-il tarifé ?
Le tarif dépend de l’opération et du mode d’exécution. Consultez la référence de l’endpoint pour connaître le coût actuel en crédits, l’exigence d’authentification et les règles par élément.
