Ausgabeformate

Die Dateien mit den Domain-Informationen und den wöchentlichen Änderungen liegen im JSON-Lines-Format (.jsonl) vor – ein JSON- Datensatz pro Zeile. Die Datei mit den Domainnamen ist eine einspaltige CSV-Datei (.csv) mit einer Kopfzeile „domainName“ . Alle Datenfeed-Dateien sind mit zstd (Zstandard) komprimiert.

Dateien mit Domain-Informationen

  • Enthaltene Daten: ein erweiterter Domain-Registrierungsdatensatz pro Domain. Wenn ein Feld im aktuellen WHOIS- oder RDAP-Datensatz unkenntlich gemacht wurde oder fehlt, wird es mit dem neuesten verfügbaren Wert aus historischen WHOIS-Datensätzen ergänzt.
  • Dateinamenformat: domain_info.%date%.weekly.jsonl.zst
  • Beispiel: domain_info.sample.weekly.jsonl.zst

Jeder Datensatz besteht aus dem Domainnamen, dem Datenabschnitt mit den Registrierungsfeldern der Domain und fünf Kontaktabschnitten. Jedes Feld ist ein Objekt, das den Feldwert, das Datum der letzten Bestätigung durch unser System sowie ein Kennzeichen enthält, das angibt, ob der Wert aus historischen Datensätzen wiederhergestellt wurde, weil er leer ist oder im aktuellen Live-Datensatz unkenntlich gemacht wurde.

{
  "domainName": "example.com",
  "data": [
    {"fieldName": "createdDateISO8601", "fieldValue": "2013-07-22T00:00:00+00:00", "auditDate": "2025-05-26T14:47:11+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "updatedDateISO8601", "fieldValue": "2013-07-22T00:00:00+00:00", "auditDate": "2025-05-26T14:47:11+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "expiresDateISO8601", "fieldValue": "2026-03-22T20:15:53+00:00", "auditDate": "2025-05-26T14:47:11+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "createdDateRaw", "fieldValue": "2013-07-22", "auditDate": "2025-05-26T14:47:11+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "updatedDateRaw", "fieldValue": "2013-07-22", "auditDate": "2025-05-26T14:47:11+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "expiresDateRaw", "fieldValue": "2026-03-22T20:15:53.197Z", "auditDate": "2025-05-26T14:47:11+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "nameServers", "fieldValue": "ns1.example.com|ns2.example.com", "auditDate": "2025-05-26T14:47:11+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "whoisServer", "fieldValue": "whois.example-registrar.com", "auditDate": "2025-05-26T14:47:11+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "registrarName", "fieldValue": "Example Registrar, Inc.", "auditDate": "2025-05-26T14:47:11+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "status", "fieldValue": "clientTransferProhibited", "auditDate": "2025-05-26T14:47:11+00:00", "isEmptyOrRedactedNow": false}
  ],
  "registrantContact": [
    {"fieldName": "name", "fieldValue": "John Doe", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "organization", "fieldValue": "Example Inc.", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "street", "fieldValue": "123 Example Street", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "city", "fieldValue": "Jacksonville", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "state", "fieldValue": "FL", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "postalCode", "fieldValue": "32256", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "country", "fieldValue": "UNITED STATES", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "email", "fieldValue": "[email protected]", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "telephone", "fieldValue": "13105551234", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "telephoneExt", "fieldValue": "", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "fax", "fieldValue": "", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "faxExt", "fieldValue": "", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true}
  ],
  "administrativeContact": [ ... ],
  "technicalContact": [ ... ],
  "billingContact": [ ... ],
  "zoneContact": [ ... ]
}

Datensatzstruktur

domainName

Der zugehörige Domainname.

Daten

Die Felder des Registrierungsdatensatzes der Domain (Daten, Nameserver, Registrar, Status). Ein Array aus Feldobjekten (siehe „Struktur des Feldobjekts“ weiter unten).

AnmelderKontakt

Enthält die Kontaktdaten des Registranten. Ein Array aus Feldobjekten.

Ansprechpartner für administrative Angelegenheiten

Enthält Kontaktdaten der Verwaltung. Die Struktur entspricht der des Feldes „registrantContact “.

technischer Ansprechpartner

Enthält technische Kontaktdaten. Der Aufbau entspricht dem des Feldes „registrantContact “.

Ansprechpartner für die Rechnungsstellung

Enthält die Kontaktdaten für die Rechnungsstellung. Die Struktur entspricht der des Feldes „registrantContact “.

zoneContact

Enthält Kontaktdaten der Zone. Die Struktur entspricht der des Feldes „registrantContact “.

Struktur des Feldobjekts

Jedes Feld in den Abschnitten „Daten“ und „Kontakt“ ist ein Objekt mit den folgenden Schlüsseln:

fieldName

Der Name des Feldes (siehe die untenstehenden Feldlisten).

fieldValue

Der aussagekräftigste verfügbare Wert für das Feld. Entnommen aus dem aktuellen WHOIS-/RDAP-Eintrag, sofern dort definiert; andernfalls aus dem letzten historischen WHOIS-Eintrag wiederhergestellt, der diesen Wert enthielt. Eine leere Zeichenkette oder „null“, falls noch nie ein Wert erfasst wurde.

Prüfungsdatum

Das Datum, an dem der Wert des Feldes zuletzt von unserem System bestätigt oder erfasst wurde, im ISO-8601-Format.

isEmptyOrRedactedNow

„true“, wenn das Feld im aktuellen Live-Datensatz leer ist oder unkenntlich gemacht wurde – das bedeutet, dass der angezeigte Wert aus historischen WHOIS-Daten wiederhergestellt wurde. „false“, wenn der Wert aus dem aktuellen Datensatz stammt.

Felder des Datenabschnitts

createdDateISO8601

Das Datum der Registrierung der Domain im ISO-8601-Format.

updatedDateISO8601

Das Datum, an dem der Registrierungsdatensatz der Domain zuletzt aktualisiert wurde, im ISO-8601-Format.

Ablaufdatum (ISO 8601)

Das Ablaufdatum der Domainregistrierung im ISO-8601-Format.

Erstellungsdatum (Rohdaten)

Das Datum, an dem der WHOIS-Eintrag für die Domain ursprünglich erstellt wurde, im Rohformat.

updatedDateRaw

Das Datum, an dem der WHOIS-Eintrag für die Domain zuletzt aktualisiert wurde, im Rohformat.

expiresDateRaw

Das Datum, an dem der WHOIS-Eintrag für die Domain abgelaufen ist, im Rohformat.

Namensserver

Die Nameserver der Domain, getrennt durch „|“.

whoisServer

Der WHOIS-Server, von dem der Eintrag abgerufen wurde.

registrarName

Name des Registrars

Status

Felder der Kontaktabschnitte

Alle fünf Kontaktabschnitte (registrantContact, administrativeContact, technicalContact, billingContact, zoneContact) weisen dieselbe Feldliste auf:

Name

Der Name des Ansprechpartners.

Organisation

Die Organisation des Ansprechpartners.

Straße

Die Anschrift des Ansprechpartners.

Stadt

Die Stadt des Ansprechpartners.

Zustand

Der Bundesstaat oder die Region des Kontakts.

Postleitzahl

Die Postleitzahl des Ansprechpartners.

Land

Das Land des Ansprechpartners.

E-Mail

Die E-Mail-Adresse des Ansprechpartners.

Telefon

Die Telefonnummer des Ansprechpartners.

TelefonExt

Die Durchwahlnummer des Ansprechpartners.

Fax

Die Faxnummer des Ansprechpartners.

FaxExt

Die Faxdurchwahl des Ansprechpartners.

Dateien mit Domainnamen

  • Enthaltene Daten: die vollständige Liste der vom Datenfeed erfassten Domainnamen, ohne deren Registrierungsdaten.
  • Dateinamenformat: domain_names.%date%.weekly.csv.zst
  • Beispiel für einen Dateinamen: domain_names.2026-07-13.weekly.csv.zst
  • Beispiel: domain_names.sample.weekly.csv.zst
  • Format: einspaltige CSV-Datei – eine Kopfzeile mit dem Feld „domainName“, gefolgt von jeweils einem Domainnamen pro Zeile.
Domainname
example.com
example.net
example.org
...

Dateien mit wöchentlichen Änderungen

  • Enthaltene Daten: die Domains, deren Einträge im Laufe der Woche hinzugefügt oder aktualisiert wurden.
  • Dateinamenformat: domain_info.%date%.weekly.diff.jsonl.zst
  • Beispiel für einen Dateinamen: domain_info.2026-07-13.weekly.diff.jsonl.zst
  • Beispiel: domain_info.sample.weekly.diff.jsonl.zst

Jede Zeile ist ein Datensatz mit derselben Struktur wie in den Domain-Info-Dateien (dem Daten abschnitt und den fünf Kontaktabschnitten), dem zwei Schlüssel vorangestellt sind: „changeType“, der angibt, warum die Domain in der Datei enthalten ist, und „domainName“.

{
  "changeType": "updated",
  "domainName": "example.com",
  "data": [
    {"fieldName": "createdDateISO8601", "fieldValue": "2024-08-19T18:26:12+00:00", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "updatedDateISO8601", "fieldValue": "2025-09-26T07:58:15+00:00", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "expiresDateISO8601", "fieldValue": "2026-08-19T18:26:12+00:00", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "createdDateRaw", "fieldValue": "2024-08-19T18:26:12Z", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "updatedDateRaw", "fieldValue": "2025-09-26T07:58:15Z", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "expiresDateRaw", "fieldValue": "2026-08-19T18:26:12Z", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "nameServers", "fieldValue": "ns1.example.com|ns2.example.com", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "whoisServer", "fieldValue": "whois.example-registrar.com", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "registrarName", "fieldValue": "Example Registrar, Inc.", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "status", "fieldValue": "clientTransferProhibited", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false}
  ],
  "registrantContact": [
    {"fieldName": "name", "fieldValue": "Statutory Masking Enabled", "auditDate": "2025-08-20T00:00:00+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "organization", "fieldValue": "Statutory Masking Enabled", "auditDate": "2025-08-20T00:00:00+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "street", "fieldValue": "123 Example Street", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "city", "fieldValue": "Jacksonville", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "state", "fieldValue": "FL", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "postalCode", "fieldValue": "32256", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "country", "fieldValue": "UNITED STATES", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "email", "fieldValue": "[email protected]", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "telephone", "fieldValue": "13105551234", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "telephoneExt", "fieldValue": "Statutory Masking Enabled", "auditDate": "2025-08-20T00:00:00+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "fax", "fieldValue": "13105555678", "auditDate": "2024-07-02T21:01:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "faxExt", "fieldValue": "Statutory Masking Enabled", "auditDate": "2025-08-20T00:00:00+00:00", "isEmptyOrRedactedNow": false}
  ],
  "administrativeContact": [ ... ],
  "technicalContact": [ ... ],
  "billingContact": [ ... ],
  "zoneContact": [
    {"fieldName": "name", "fieldValue": null, "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": true},
    ...
  ]
}

Beschreibung des Ausgabefelds

changeType

Warum die Domain in der Änderungsdatei dieser Woche aufgeführt ist. Einer der folgenden Gründe:

  • hinzugefügt – die Domain wurde in dieser Woche zum ersten Mal gesichtet.
  • Aktualisiert – die Domain war bereits vor dieser Woche bekannt, und ihre Einträge wurden im Laufe dieser Woche geändert.
domainName

Der zugehörige Domainname.

data,
registrantContact,
administrativeContact,
technicalContact,
billingContact,
zoneContact

Genau wie in den Domänen-Infodateien – siehe „Datensatzstruktur“ und „Feldobjektstruktur“ weiter oben. Ein Feld, das im aktuellen Live-Datensatz fehlt und keinen historischen Wert aufweist, hat einen Feldwert von „null“, wobei „isEmptyOrRedactedNow“ auf „true“ gesetzt ist.