Faire des demandes | Documentation | Registrant Alert API | WhoisXML API

Formuler des demandes

API endpoint

POST https://registrant-alert.whoisxmlapi.com/api/v2
L'activation de votre compte après l'enregistrement prend jusqu'à une minute.

Notez que les résultats de la recherche sont limités à 10 000 enregistrements. Si vous souhaitez obtenir des résultats plus pertinents, essayez d'optimiser votre requête de recherche ou d'utiliser la recherche avancée.

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

{
    "apiKey": "API_KEY",
    "sinceDate": "2019-04-20",
    "mode": "purchase",
    "punycode": true,
    "basicSearchTerms":
    {
        "include": [
            "Airbnb",
            "US"
        ],
        "exclude": [
            "Europe",
            "EU"
        ]
    }
}

Vous pouvez indiquer jusqu'à quatre termes de recherche (inclusion et exclusion) dans une même demande. Avec plusieurs termes de recherche d'inclusion/exclusion, le résultat comprend des domaines ayant tous les termes d'inclusion et aucun des termes d'exclusion.

Le résultat comprend les domaines ajoutés ou supprimés par les déclarants dont les termes figurent dans l'un des champs suivants :

Champs de contact du déclarant

RegistrantContact.City, RegistrantContact.Country, RegistrantContact.Email, RegistrantContact.Fax, RegistrantContact.FaxExtension, RegistrantContact.Name, RegistrantContact.Organization, RegistrantContact.PostalCode, RegistrantContact.State, RegistrantContact.StreetAddress, RegistrantContact.Telephone, RegistrantContact.TelephoneExtension

En-têtes

X-Authentication-Token

Vous pouvez utiliser cet en-tête ou le paramètre apiKey pour les appels à l'API.

Obtenez votre CLÉ d'API personnelle sur la page Mes produits.

Paramètres d'entrée

apiKey

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

basicSearchTerms.include

Requis. Tableau de chaînes de recherche. Elles doivent toutes être présentes dans les données du registrant du domaine. Maximum 4 éléments. Insensible aux majuscules et minuscules.

basicSearchTerms.exclude

Facultatif. Tableau de chaînes de recherche. Toutes ces chaînes ne doivent PAS être présentes dans les détails du registrant du domaine. Maximum 4 éléments. Insensible aux majuscules et minuscules.

sinceDate

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

Les dates autorisées se situent dans l'intervalle [Aujourd'hui moins 14 jours - Aujourd'hui].

Par défaut, il s'agit de la date d'hier.

Notez que les résultats de la journée d'hier sont généralement disponibles entre 10 et 12 heures UTC.

Si elle est présente, la recherche porte sur les activités découvertes depuis la date donnée. Il existe parfois un décalage entre la date réelle d'ajout/renouvellement/expiration et la date à laquelle notre système a détecté ce changement. Nous vous recommandons d'utiliser ce champ dans vos outils de surveillance pour filtrer les changements quotidiens.

mode

Facultatif.

preview - ne renvoie que le nombre de domaines. Aucun crédit n'est déduit.

purchase - renvoie la liste actuelle des domaines (limitée à 10 000). 1 demande coûte 10 crédits DRS.

Valeurs acceptables : preview | purchase

Valeur par défaut : preview

punycode

Facultatif. Si ''true'', les noms de domaine dans la réponse seront encodés en Punycode.

Valeurs acceptables : false | true

Valeur par défaut : true

responseFormat

Facultatif. Format de sortie de la réponse.

Valeurs acceptables : json | xml

Valeur par défaut : json

createdDateFrom

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

Si elle est présente, la recherche porte sur les domaines créés après la date donnée.

createdDateTo

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

Si elle est présente, la recherche porte sur les domaines créés avant la date donnée.

updatedDateFrom

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

Si elle est présente, la recherche porte sur les domaines créés après la date donnée.

updatedDateTo

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

Si elle est présente, la recherche porte sur les domaines mis à jour avant la date donnée.

expiredDateFrom

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

S'il est présent, la recherche porte sur les domaines expirés après la date donnée.

expiredDateTo

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

S'il est présent, il recherche les domaines expirés avant la date donnée.

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, les 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 Services API Premium et nos Packs Enterprise.

Advanced search API docs

La recherche avancée permet d'effectuer des recherches dans des champs WHOIS concrets.