Anfragen stellen

Übersicht

Die Typosquatting-API bietet vier Endpunkte zur Erkennung und Untersuchung von Typosquatting-Domains. Alle Anfragen erfolgen über HTTP GET.

1. Domain prüfen

Ermitteln Sie die Typosquatting-Gruppen, zu denen eine Domain gehört.

Eine Anfrage kostet 1 DRS-Punkt.

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

Eingabeparameter

API-Schlüssel

Erforderlich. Rufen Sie Ihren persönlichen API-Schlüssel auf der Seite „Meine Produkte “ ab.

Domainname

Erforderlich. Der Domainname, der auf die Zugehörigkeit zu einer Typosquatting-Gruppe überprüft werden soll. Es werden beliebige UTF-8-Zeichenfolgen akzeptiert.

Ausgabeformat

Optional. Ausgabeformat der Antwort.

Zulässige Werte: JSON | XML

Standard: JSON

Beispielausgabe

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

Ausgabefelder

Datum
Das Datum, an dem die Typosquatting-Gruppe entdeckt wurde, im Format JJJJ-MM-TT.
Gruppennummer
Die Kennung der Typosquatting-Gruppe für das angegebene Datum.
Gesamtzahl der Gruppenmitglieder
Die Gesamtzahl der Domains in dieser Typosquatting-Gruppe.

2. Domain prüfen (erweitert)

Rufen Sie erweiterte Daten für alle Domains in allen Gruppen ab, zu denen die angegebene Domain gehört. Dies ist die detaillierteste Abfrage für eine einzelne Domain, die vollständige WHOIS- und Registrierungsdaten für jedes Gruppenmitglied liefert.

Eine Anfrage kostet 5 DRS-Credits.

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

Eingabeparameter

API-Schlüssel

Erforderlich. Rufen Sie Ihren persönlichen API-Schlüssel auf der Seite „Meine Produkte “ ab.

Domainname

Erforderlich. Der zu prüfende Domainname. Akzeptiert beliebige UTF-8-Zeichenfolgen. Die Beispiel-Domain „iwin.exposed“ eignet sich gut zum Testen, da sie in mehreren Gruppen vorkommt.

Ausgabeformat

Optional. Ausgabeformat der Antwort.

Zulässige Werte: JSON | XML

Standard: JSON

Beispielausgabe

Gibt ein JSON-Array mit angereicherten Datensätzen zurück. Eine vollständige Beschreibung der Felder finden Sie im Abschnitt „Angereicherte Ausgabefelder“ weiter unten.

3. Gruppe bilden

Rufen Sie alle Domains einer bestimmten Typosquatting-Gruppe ab (Basisfelder).

Eine Anfrage kostet 5 DRS-Credits.

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

Eingabeparameter

API-Schlüssel

Erforderlich. Rufen Sie Ihren persönlichen API-Schlüssel auf der Seite „Meine Produkte “ ab.

Datum

Erforderlich. Das Erkennungsdatum im Format JJJJ-MM-TT. Muss größer oder gleich dem 01.07.2020 sein.

Gruppennummer

Erforderlich. Die Nummer der Typosquatting-Gruppe (Ganzzahl).

Ausgabeformat

Optional. Ausgabeformat der Antwort.

Zulässige Werte: JSON | XML

Standard: JSON

Beispielausgabe

[
    {
        "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"
    }
]

Ausgabefelder

Datum
Das Datum, an dem die Typosquatting-Gruppe entdeckt wurde, im Format JJJJ-MM-TT.
Gruppennummer
Die Kennung der Typosquatting-Gruppe.
Gruppenmitgliedsnummer
Die Position des Mitglieds innerhalb der Gruppe, aufsteigend geordnet.
Gesamtzahl der Gruppenmitglieder
Die Gesamtzahl der Domains in dieser Gruppe.
Domäne
Der Domainname (ASCII).
domainUtf
Der Domainname in UTF-8-Kodierung (nützlich für internationalisierte Domainnamen).

4. Gruppe abrufen (erweitert)

Rufen Sie alle Domains einer bestimmten Typosquatting-Gruppe mit vollständigen, erweiterten WHOIS- und Registrierungsdaten ab.

Eine Anfrage kostet 5 DRS-Credits.

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

Eingabeparameter

API-Schlüssel

Erforderlich. Rufen Sie Ihren persönlichen API-Schlüssel auf der Seite „Meine Produkte “ ab.

Datum

Erforderlich. Das Erkennungsdatum im Format JJJJ-MM-TT. Muss größer oder gleich dem 01.07.2020 sein.

Gruppennummer

Erforderlich. Die Nummer der Typosquatting-Gruppe (Ganzzahl).

Ausgabeformat

Optional. Ausgabeformat der Antwort.

Zulässige Werte: JSON | XML

Standard: JSON

Beispielausgabe

Gibt ein JSON-Array mit angereicherten Datensätzen zurück. Eine vollständige Beschreibung der Felder finden Sie im Abschnitt „Angereicherte Ausgabefelder“ weiter unten.

Erweiterte Ausgabefelder

Die angereicherten Endpunkte (checkDomainEnriched, getGroupEnriched) geben für jeden Datensatz die folgenden Felder zurück:

Datum
Das Datum, an dem die Typosquatting-Gruppe entdeckt wurde, im Format JJJJ-MM-TT.
Gruppennummer
Die Kennung der Typosquatting-Gruppe.
Gruppenmitgliedsnummer
Die Stellung des Mitglieds innerhalb der Gruppe.
Gesamtzahl der Gruppenmitglieder
Die Gesamtzahl der Domains in dieser Gruppe.
Domäne
Der Domainname (ASCII).
domainUtf
Der Domainname in UTF-8-Kodierung.
Name des Registranten
Der Name des Registranten aus den WHOIS-Einträgen.
Anmelderorganisation
Die Organisation des Registranten.
Land des Registranten
Das Land des Registranten.
Registrierungsstaat
Der Bundesstaat oder die Provinz des Registranten.
Registrierungsort
Der Wohnort des Registranten.
E-Mail-Adresse des Registranten
Die E-Mail-Adresse des Registranten.
Name des Registrars
Der Name des Domain-Registrars.
Registrar-IANA-ID
Die IANA-ID des Registrars.
whoisServer
Der WHOIS-Server für die Domain.
Namensserver
Die mit der Domain verknüpften Nameserver.
Status
Die Domain-Statuscodes (z. B. „clientTransferProhibited“).
Erstellungsdatum
Das vom Registrar angegebene Erstellungsdatum der Domain.
Aktualisierungsdatum
Das Datum der letzten Aktualisierung der Domain, wie es vom Registrar gemeldet wurde.
Ablaufdatum
Das vom Registrar angegebene Ablaufdatum der Domain.
standardRegCreatedDate
Das standardisierte Erstellungsdatum der Domain im Format JJJJ-MM-TT HH:MM:SS.
standardRegUpdatedDate
Das standardisierte Datum der letzten Aktualisierung der Domain im Format JJJJ-MM-TT HH:MM:SS.
Standard-Gültigkeitsdatum
Das standardisierte Ablaufdatum der Domain im Format JJJJ-MM-TT HH:MM:SS.
ips
Die mit der Domain verbundenen IP-Adressen.

Preisgestaltung

Jeder Endpunkt zieht pro erfolgreicher Anfrage eine feste Anzahl von DRS-Credits ab:

Die Aktivierung Ihres Kontos nach der Registrierung dauert bis zu einer Minute.

Freier Zugang

Nach der Anmeldung erhalten Sie automatisch ein kostenloses Abonnement mit einem Kontingent von 500 DRS-Credits.

Nutzungsbeschränkungen und Drosselung von Anfragen

Die maximale Anzahl von Anfragen pro Sekunde beträgt 30. Sollte dieses Limit überschritten werden, werden Ihre nachfolgenden Anfragen bis zur nächsten Sekunde abgelehnt.

Diese API ist auch mit einem dedizierten Load Balancer und einem Premium-Endpunkt verfügbar, um schnellere Abfragen als Teil unserer Premium-API-Dienste und Enterprise-API-Pakete zu ermöglichen.