Formuler des demandes

Aperçu

L'API Typosquatting propose quatre points de terminaison permettant de détecter et d'analyser les domaines de typosquatting. Toutes les requêtes sont effectuées via HTTP GET.

1. Vérifier le nom de domaine

Identifiez les groupes de typosquatting auxquels appartient un domaine.

Une demande coûte 1 crédit DRS.

OBTENIR https://typosquatting.whoisxmlapi.com/api/v1/checkDomain?apiKey=YOUR_API_KEY&domainName=amoreresidences.com

Paramètres d'entrée

apiKey	Obligatoire. Récupérez votre clé API personnelle sur la page « Mes produits ».
nom de domaine	Obligatoire. Le nom de domaine à vérifier pour déterminer s'il fait partie d'un groupe de typosquatting. Accepte toute chaîne de caractères au format UTF-8.
format de sortie	Facultatif. Format de sortie de la réponse. Valeurs acceptées : JSON \| XML Par défaut : JSON

Exemple de résultat

[
    {
        "date": "2022-05-10",
        "groupNumber": 1,
        "totalNoOfGrpMembers": 13
    }
]

Champs de sortie

date	La date à laquelle le groupe de typosquatting a été détecté, au format AAAA-MM-JJ.
numéro de groupe	L'identifiant du groupe de typosquatting pour la date indiquée.
nombre total de membres du groupe	Le nombre total de domaines appartenant à ce groupe de typosquatting.

2. Vérifier le domaine (enrichi)

Obtenez des données détaillées pour tous les domaines de tous les groupes auxquels appartient le domaine indiqué. Il s'agit de la requête la plus détaillée portant sur un seul domaine ; elle renvoie les informations WHOIS complètes ainsi que les détails d'enregistrement pour chaque membre du groupe.

Une demande coûte 5 crédits DRS.

OBTENIR https://typosquatting.whoisxmlapi.com/api/v1/checkDomainEnriched?apiKey=YOUR_API_KEY&domainName=iwin.exposed

Paramètres d'entrée

apiKey	Obligatoire. Récupérez votre clé API personnelle sur la page « Mes produits ».
nom de domaine	Obligatoire. Le nom de domaine à vérifier. Accepte toute chaîne de caractères au format UTF-8. Le domaine d'exemple « iwin.exposed » est utile pour les tests, car il apparaît dans plusieurs groupes.
format de sortie	Facultatif. Format de sortie de la réponse. Valeurs acceptées : JSON \| XML Par défaut : JSON

Exemple de résultat

Renvoie un tableau JSON contenant des enregistrements enrichis. Reportez-vous à la section consacrée aux champs de sortie enrichis ci-dessous pour obtenir une description complète des champs.

3. Créer un groupe

Récupérez tous les domaines d'un groupe de typosquatting spécifique (champs de base).

Une demande coûte 5 crédits DRS.

OBTENIR https://typosquatting.whoisxmlapi.com/api/v1/getGroup?apiKey=YOUR_API_KEY&date=2022-05-10&groupNumber=1

Paramètres d'entrée

apiKey	Obligatoire. Récupérez votre clé API personnelle sur la page « Mes produits ».
date	Obligatoire. La date de détection au format AAAA-MM-JJ. Doit être postérieure au 01/07/2020.
numéro de groupe	Obligatoire. Le numéro du groupe de typosquatting (entier).
format de sortie	Facultatif. Format de sortie de la réponse. Valeurs acceptées : JSON \| XML Par défaut : JSON

Exemple de résultat

[
    {
        "date": "2022-05-10",
        "groupNumber": 1,
        "groupMemberNumber": 1,
        "totalNoOfGrpMembers": 13,
        "domain": "example1.com",
        "domainUtf": "example1.com"
    },
    {
        "date": "2022-05-10",
        "groupNumber": 1,
        "groupMemberNumber": 2,
        "totalNoOfGrpMembers": 13,
        "domain": "example2.com",
        "domainUtf": "example2.com"
    }
]

Champs de sortie

date	La date à laquelle le groupe de typosquatting a été détecté, au format AAAA-MM-JJ.
numéro de groupe	L'identifiant du groupe de typosquatting.
nombre de membres du groupe	La position du membre au sein du groupe, classée par ordre croissant.
nombre total de membres du groupe	Le nombre total de domaines dans ce groupe.
domaine	Le nom de domaine (ASCII).
domainUtf	Le nom de domaine au format UTF-8 (utile pour les noms de domaine internationalisés).

4. Obtenir le groupe (enrichi)

Obtenez tous les domaines d'un groupe spécifique de typosquatting, accompagnés de données WHOIS et d'enregistrement complètes et détaillées.

Une demande coûte 5 crédits DRS.

OBTENIR https://typosquatting.whoisxmlapi.com/api/v1/getGroupEnriched?apiKey=YOUR_API_KEY&date=2022-05-10&groupNumber=1

Paramètres d'entrée

apiKey	Obligatoire. Récupérez votre clé API personnelle sur la page « Mes produits ».
date	Obligatoire. La date de détection au format AAAA-MM-JJ. Doit être postérieure au 01/07/2020.
numéro de groupe	Obligatoire. Le numéro du groupe de typosquatting (entier).
format de sortie	Facultatif. Format de sortie de la réponse. Valeurs acceptées : JSON \| XML Par défaut : JSON

Exemple de résultat

Renvoie un tableau JSON contenant des enregistrements enrichis. Reportez-vous à la section consacrée aux champs de sortie enrichis ci-dessous pour obtenir une description complète des champs.

Champs de sortie enrichis

Les méthodes enrichies (checkDomainEnriched, getGroupEnriched) renvoient les champs suivants pour chaque enregistrement :

date	La date à laquelle le groupe de typosquatting a été détecté, au format AAAA-MM-JJ.
numéro de groupe	L'identifiant du groupe de typosquatting.
nombre de membres du groupe	La place du membre au sein du groupe.
nombre total de membres du groupe	Le nombre total de domaines dans ce groupe.
domaine	Le nom de domaine (ASCII).
domainUtf	Le nom de domaine en codage UTF-8.
nom du titulaire	Le nom du titulaire tel qu'il figure dans les enregistrements WHOIS.
organisation du titulaire	L'organisation du déclarant.
pays du titulaire	Pays du titulaire du nom de domaine.
État d'enregistrement	L'État ou la province de l'inscrit.
ville du titulaire	La ville du déclarant.
adresse e-mail du titulaire	L'adresse e-mail du titulaire du nom de domaine.
nom du registraire	Le nom du registraire de domaine.
registraireIANAID	L'identifiant IANA du bureau d'enregistrement.
whoisServer	Le serveur WHOIS du domaine.
serveurs de noms	Les serveurs de noms associés au domaine.
statut	Les codes d'état du domaine (par exemple, clientTransferProhibited).
date de création	La date de création du domaine telle qu'indiquée par le registraire.
Date de mise à jour	Date de la dernière mise à jour du domaine telle qu'indiquée par le registraire.
date d'expiration	La date d'expiration du domaine telle qu'indiquée par le registraire.
date de création standard	La date de création normalisée du domaine au format AAAA-MM-JJ HH:MM:SS.
date de mise à jour de la norme	La date de dernière mise à jour normalisée du domaine, au format AAAA-MM-JJ HH:MM:SS.
date d'expiration standard	La date d'expiration standardisée du domaine au format AAAA-MM-JJ HH:MM:SS.
ips	Les adresses IP associées au domaine.

Tarification

Chaque point de terminaison déduit un nombre fixe de crédits DRS pour chaque requête aboutie :

Vérification du domaine: 1 crédit DRS
Vérification du domaine (approfondie): 5 crédits DRS
Obtenir le groupe: 5 crédits DRS
Cours en groupe (approfondi): 5 crédits DRS

L'activation de votre compte peut prendre jusqu'à une minute après votre inscription.

Accès gratuit

Une fois votre inscription effectuée, vous bénéficiez automatiquement d'un abonnement gratuit limité à 500 crédits DRS.

Limites d'utilisation et régulation des requêtes

Le nombre maximal de requêtes par seconde est de 30. Si cette limite est dépassée, vos requêtes suivantes seront rejetées jusqu'à la seconde suivante.

Cette API est également disponible avec un équilibreur de charge dédié et un point de terminaison premium afin de permettre des requêtes plus rapides dans le cadre de nos services API Premium et de nos offres API Entreprise.

WHOIS / WHOIS History

DNS / DNS History

IP Geolocation / IP Netblocks

Domaine/WHOIS

DNS/IP

Renseignement

Autres

Domaine/WHOIS

DNS/IP

Renseignement

Autres

Domaine/WHOIS

DNS/IP

Renseignement

Autres

Recherche

Contrôle

Label blanc

Formuler des demandes

Aperçu

1. Vérifier le nom de domaine

Paramètres d'entrée

Exemple de résultat

Champs de sortie

2. Vérifier le domaine (enrichi)

Paramètres d'entrée

Exemple de résultat

3. Créer un groupe

Paramètres d'entrée

Exemple de résultat

Champs de sortie

4. Obtenir le groupe (enrichi)

Paramètres d'entrée

Exemple de résultat

Champs de sortie enrichis

Tarification

Accès gratuit

Limites d'utilisation et régulation des requêtes

Vous avez des questions ?