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

Formuler des demandes

API endpoint

POST https://brand-alert.whoisxmlapi.com/api/v2
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

{
    "apiKey": "YOUR_API_KEY",
    "sinceDate": "2024-10-05",
    "mode": "purchase",
    "withTypos": false,
    "responseFormat": "json",
    "punycode": true,
    "includeSearchTerms": [
        "google",
        "blog"
    ],
    "excludeSearchTerms": [
        "analytics"
    ]
}

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.

includeSearchTerms

Requis. Tableau de termes de recherche. Ils doivent tous être présents dans le nom de domaine. Maximum 4 éléments. Insensible aux majuscules et aux minuscules.

excludeSearchTerms

Facultatif. Tableau de termes de recherche. Tous ces termes ne doivent PAS être présents dans le nom de 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 c'est le cas, la recherche porte sur les activités découvertes depuis la date donnée. Il y a parfois un 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 - renvoie uniquement le nombre de domaines. Aucun crédit n'est déduit.

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

Valeurs acceptables : aperçu | achat

Valeur par défaut : preview

withTypos

Facultatif. Si elle est vraie, l'ensemble des termes de recherche sera enrichi de leurs éventuelles fautes de frappe. Par exemple, pour le terme "google", les fautes de frappe peuvent être les suivantes : 'goigle', 'gokgle', 'golgle', 'gopgle', 'goglee', 'gooogle', etc.

Valeurs acceptables : false | true

Valeur par défaut : false

Avec les fautes de frappe - 1 demande coûte 300 crédits DRS.

En savoir plus : FAQ sur la génération de fautes de frappe

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

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.