Faire des demandes | Documentation | Domains & Subdomains Discovery API | WhoisXML API

Formuler des demandes

API endpoint

POST https://domains-subdomains-discovery.whoisxmlapi.com/api/v1
L'activation de votre compte après l'enregistrement prend jusqu'à une minute.

Collection de Postman

Postman est une application web et de bureau qui vous permet de faire des demandes à une API à partir d'une interface utilisateur graphique. Nous recommandons d'utiliser Postman avec les points d'extrémité des API WhoisXML pour explorer les fonctionnalités des API, ainsi que pour résoudre les problèmes liés à votre application.

La collection Postman de l'API WhoisXML est disponible aux liens suivants :

La collection comprend un environnement préconfiguré. Vous devrez configurer la clé_api pour déclencher chaque requête. Obtenez votre CLÉ d'API personnelle sur la page Mes produits. Si vous avez des questions relatives à l'API, contactez-nous.

Exemple de corps de requête POST : domaines uniquement (1 crédit DRS)

Renvoyer uniquement les domaines qui correspondent aux termes de recherche spécifiés dans les zones de domaine et de TLD, à l'exclusion des zones de sous-domaine.

{
    "apiKey": "YOUR_API_KEY",
    "domains": {
        "include": [
            "amazon.*"
        ]
    }
}

Exemple de corps de requête POST : sous-domaines uniquement (10 crédits DRS)

Renvoyer uniquement les sous-domaines qui correspondent aux termes de recherche spécifiés dans les zones de sous-domaines, à l'exclusion des zones de domaines et de TLD.

{
    "apiKey": "YOUR_API_KEY",
    "subdomains": {
        "include": [
            "adidas*"
        ],
        "exclude": [
            "*shoes*"
        ]
    }
}

Exemple de corps de requête POST : domaines et sous-domaines (11 crédits DRS)

Retourne les domaines ET les sous-domaines qui correspondent aux termes de recherche spécifiés dans le nom d'hôte entier.

{
    "apiKey": "YOUR_API_KEY",
    "domains": {
        "include": [
            "amazon.com"
        ]
    },
    "subdomains": {
        "include": [
            "aws*"
        ],
        "exclude": [
            "*portal*",
            "*beta*"
        ]
    }
}

Vous pouvez indiquer jusqu'à quatre termes de recherche (inclusion et exclusion) dans une même demande.

Paramètres d'entrée

apiKey

Nécessaire. Obtenez votre clé API personnelle sur la page Mes produits.

[domaines|sous-domaines].include

Requis. Tableau des termes de recherche inclus. Maximum 4 éléments. Insensible aux majuscules et minuscules.

[domaines|sous-domaines].exclure

Facultatif. Tableau de termes de recherche exclus. Maximum 4 éléments. Insensible à la casse.

sinceDate

Facultatif. Date au format "YYYY-MM-DD".

Si elle est présente, la recherche porte sur les domaines/sous-domaines découverts depuis la date donnée.

outputFormat

Facultatif. Format de sortie de la réponse.

Valeurs acceptables : JSON | XML

Par défaut : JSON

1 requête à Domaines & Subdomains Discovery API coûte :

  • Domaines uniquement : 1 crédit DRS
  • Sous-domaines uniquement : 10 crédits DRS
  • Domaines et sous-domaines : 11 crédits DRS

Wildcard Search

Vous pouvez utiliser des caractères génériques pour effectuer des recherches. Notez que de telles requêtes peuvent être lentes.

{
    "apiKey": "YOUR_API_KEY",
    "domains": {
        "include": [
            "amazon.*"
        ]
    },
    "subdomains": {
        "include": [
            "aws*"
        ],
        "exclude": [
            "*portal*",
            "*beta*"
        ]
    }
}

Accès gratuit

Après l'inscription, vous bénéficiez automatiquement d'un plan d'abonnement gratuit limité à 500 crédits DRS.

Limitation de l'utilisation et des demandes

Le nombre maximum de demandes par seconde est de 30. Si la limite est dépassée, vos demandes suivantes seront rejetées jusqu'à la seconde suivante.

Cette API est également disponible avec un équilibreur de charge dédié et un point d'extrémité premium pour permettre des requêtes plus rapides dans le cadre de nos Premium API Services et Enterprise API Packages.