API v1 Dokumentation

Informationen über unterstützte Methoden, Parameter, zurückgegebene Daten und Beispiele.

Warnung: Die API befindet sich derzeit in der Entwicklung und unterliegt zusätzlichen Funktionen: neue Methoden und Parameter können in Zukunft hinzugefügt werden. Alle vorgenommenen Änderungen bleiben rückwärtskompatibel mit der bestehenden Funktionalität.

Übersicht

Die TLD-List v1 API kann verwendet werden, um die auf TLD-List angezeigten Daten aus der Live-Datenbank abzurufen.

Die API akzeptiert HTTP POSTs mit JSON-Daten und antwortet mit JSON-Daten. Anforderungen für alle API-Methodenanfragen:

  • Die Anfragen müssen mit der HTTP POST-Methode gestellt werden
  • Anfragen müssen einen JSON-Text enthalten, der ein gültiges öffentliches und privates API-Schlüsselpaar zur Authentifizierung enthält.
  • Anfragen müssen die Kopfzeile enthalten: Inhalt-Typ: application/json

Parameter werden als Schlüssel/Werte im JSON-kodierten Anfragekörper an die API übergeben.

Die Basis-URL für alle API-Anfragen lautet:

https://api.tld-list.com/v1

Authentifizierung

Die Authentifizierung erfolgt durch die Übergabe eines öffentlichen API-Schlüssels und eines privaten API-Schlüssels im JSON-Körper, der an die URL der Methode gesendet wird. Alle API-Aufrufe müssen ein gültiges API-Schlüsselpaar enthalten. API-Schlüsselpaare können in Ihrem TLD-List Konto unter der Registerkarte API generiert werden.

Besuchen Sie Konto > API, um API-Schlüssel zu erstellen.

API-Schlüssel werden im JSON-Anfragekörper mit den Parametern apiKeyPublic (Ihr öffentlicher Schlüssel) und apiKeyPrivate (Ihr privater Schlüssel) übergeben.

Example authentication parameters

{
    "apiKeyPublic":"MY_PUBLIC_KEY",
    "apiKeyPrivate":"MY_PRIVATE_KEY" 
}

Antwort

Alle erfolgreichen API-Antworten haben den HTTP-Statuscode 200 SUCCESS und einen JSON-kodierten Textkörper. Jeder andere HTTP-Statuscode in der Antwort bedeutet, dass die Anfrage fehlgeschlagen ist und ein Fehler aufgetreten ist.

JSON-Antwortobjekte, die von der API zurückgegeben werden, haben die folgende Struktur:

Schlüssel Typ Beschreibung
status string Gibt den Status der Anfrage an. SUCCESS bedeutet, dass der API-Aufruf erfolgreich war, FAIL bedeutet, dass die Anfrage fehlgeschlagen ist.
errors array of objects Array mit Objekten, die die aufgetretenen Fehler darstellen. Jedes Fehlerobjekt enthält:

code: Zeichenkette zur Identifizierung des Fehlertyps

message: von Menschen lesbare Zeichenfolge, die den Fehler beschreibt

Parameter: optionale Zeichenkette oder Array von Zeichenketten, die ein Problem mit einem oder mehreren in der Anfrage übergebenen Parametern angibt.

Wenn keine Fehler aufgetreten sind, ist das Fehler-Array leer.

Siehe Fehlercodes für weitere Informationen.
seconds number Zeit, die der API-Server benötigt hat, um eine Antwort zu generieren (in Sekunden).
data string|array|object Ein Objekt, Array oder eine Zeichenkette mit den angeforderten Daten.

Beispiel für ein fehlgeschlagenes Antwortobjekt mit Fehlern

{
   "errors" : [
      {
         "code" : "PARAMETER_INVALID",
         "message" : "pricetypes parameter must be a non-empty array",
         "parameter" : "pricetypes"
      },
      {
         "code" : "PARAMETER_INVALID",
         "message" : "includeRegistrars parameter contains invalid registrar names: foobar",
         "parameter" : "includeRegistrars"
      }
   ],
   "seconds" : 0.001,
   "status" : "FAIL"
}

Beispiel für ein erfolgreiches Antwortobjekt

{
   "data" : [
      {
         "cheapest" : {
            "renewal" : [
               {
                  "id" : "sav",
                  "name" : "Sav",
                  "price" : "8.38"
               }
            ],
         },
         "currency" : "USD",
         "name" : "com",
         "registrarsIncluded" : 58,
         "registrarsTotal" : 58
      }
   ],
   "errors" : [],
   "seconds" : 0.001,
   "status" : "SUCCESS"
}

Gemeinsame Antwort-Objekte

Einige der API-Methoden geben Datenobjekte zurück, die die gleiche Struktur haben. Diese gemeinsamen Datenobjekte werden im Folgenden ausführlich beschrieben.

RegistrarPricing

Beschreibt die Einzelhandelspreise eines Registrars für eine Erweiterung für einen bestimmten Preistyp (register, renewal, transfer), einschließlich zusätzlicher Details wie Sonderbedingungen, Gebühren, Steuern und Werbeaktionen.

Pfad Typ Beschreibung
id string Registrar-ID-String zur eindeutigen Identifizierung des Registrars.
name string Anzeigename des Registrars.
price string Der endgültige Verkaufspreis des Registrars für die Erweiterung und den Preistyp.

Hinweis: Dieses Feld ist nur vorhanden, wenn das RegistrarPricing-Objekt im Kontext eines Preistyps verschachtelt ist (zum Beispiel in der Antwort von getCheapestRegistrars).
priceOriginal string Der reguläre Verkaufspreis des Registrars für die Erweiterung als numerische Zeichenfolge. Dieses Feld ist nur vorhanden, wenn der Preis ein Aktionspreis ist.

Hinweis: Dieses Feld ist nur vorhanden, wenn das RegistrarPricing-Objekt im Kontext eines Preistyps verschachtelt ist (zum Beispiel in der Antwort von getCheapestRegistrars).
pricetype string Der Typ der Preiserweiterung, einer von: register, renewal, transfer.

Hinweis: Dieses Feld ist nur vorhanden, wenn das RegistrarPricing-Objekt im Kontext eines Preistyps verschachtelt ist (zum Beispiel in der Antwort von getCheapestRegistrars).
prices object Der Einzelhandelspreis des Registrars für die Erweiterung für alle Preistypen.
prices[pricetype] string Der endgültige Verkaufspreis des Registrars für die Erweiterung und [pricetype], wobei der Schlüssel [pricetype] register, renewal, transfer, restore, whoisprivacy lautet. Beispiel:

{
    "register": "8.73",
    "renewal": "9.73",
    "transfer": "9.73",
    "whoisPrivacy": "0.00"
}
pricesOriginal object Der reguläre Einzelhandelspreis des Registrars für die Erweiterung für alle Preistypen. Dieses Feld ist nicht vorhanden, wenn der Registrar keine aktiven Promos hat.
pricesOriginal[pricetype] string Der reguläre Verkaufspreis des Registrars für die Erweiterung und [pricetype], wobei der Schlüssel [pricetype] register, renewal, transfer, restore, whoisprivacy lautet.
promo object Ein RegistrarPromo-Objekt, das den Aktionspreis darstellt, der auf den Preis des Registrars für diese Erweiterung und diesen Preistyp angewendet wurde. Wenn keine Promo angewandt wurde, ist dieses Feld nicht vorhanden. Beispiel für ein Promo-Objekt: 

{
    "code": "MYCOUPONCODE",
    "amount": "20.00",
    "type": "discount-percent",
    "start": "2015-06-22T00:00:00",
    "end": "2025-06-22T00:00:00"
}


Hinweis: Dieses Feld ist nur vorhanden, wenn das RegistrarPricing-Objekt im Kontext eines Preistyps verschachtelt ist (zum Beispiel in der Antwort von getCheapestRegistrars).
promos array of objects Array von RegistrarPromo-Objekten, die alle aktiven Aktionspreise des Registrars für diese Erweiterung enthalten.
terms object Eine Sammlung von Objekten, die besondere Bedingungen für die Preisgestaltung des Registrars darstellen. Wenn keine besonderen Bedingungen gelten, ist dieses Feld nicht vorhanden. Jedes Unterobjekt ist mit einer Term-ID verschlüsselt:

limitPerCustomer - gibt an, dass der Preis nur für eine bestimmte Anzahl von Domains pro Kunde gilt.
newCustomerOnly - gibt an, dass der Preis nur für Neukunden gilt.
affiliateLink - gibt an, dass der Preis nur gilt, wenn der Kunde über einen Affiliate-Link auf die Website des Registrars zugreift.
nameserverLockIn - legt fest, dass gekaufte Domains nur die Nameserver des Registrars verwenden können.
idSubmissionRequired - legt fest, dass der Kunde seinen Lichtbildausweis oder seine Gewerbeanmeldung einreichen muss, um den Kauf abzuschließen.

Beispiel für Begriffsobjekte: 

{
    "limitPerCustomer": {
        "pricetype": [
            "register"
        ],
        "count": 1
    },
    "newCustomerOnly": {
        "pricetype": [
            "register"
        ]
    },
    "affiliateLink": {
        "pricetype": [
            "register"
        ]
    },
    "multiYearPurchaseRequired": {
        "pricetype": [
            "register"
        ],
        "count": 2
    },
    "nameserverLockIn": {
        "pricetype": [
            "register",
            "renewal",
            "transfer"
        ]
    },
    "idSubmissionRequired": {
        "pricetype": [
            "register",
            "renewal",
            "transfer"
        ]
    }
}
terms[term].count number Die Menge, auf die die Bedingung den Kunden beschränkt. Wenn z.B. count = 1, dann ist der Kunde auf 1 Domain zum angegebenen Preis beschränkt. Dieses Feld wird nicht angezeigt, wenn es nicht zutrifft.
terms[term].pricetype array of strings Der/die Preistyp(en), für den/die der Begriff gilt: register, renewal, transfer. Dieses Feld ist nur vorhanden, wenn der Preistyp des RegistrarPricing-Objekts nicht angegeben ist.
notes object Eine Sammlung von Objekten, die Notizen zur Preisgestaltung des Registrars darstellen. Wenn es keine Preisnotizen gibt, ist dieser Wert ein leeres Objekt. Jedes Unterobjekt ist mit einer Notiz-ID verschlüsselt: currencyExchangeRate, feeIcann, feeTax, feePayment
notes.feeIcann object Gibt an, ob dem Endpreis für die TLD eine ICANN-Gebühr hinzugefügt wurde (normalerweise $0,18 USD). Wenn diese Notiz vorhanden ist, bedeutet dies, dass der Registrar die ICANN-Gebühr nicht in den beworbenen Preis einbezieht, sondern sie als zusätzliche Gebühr zum Preis von TLD's beim Checkout des Kunden hinzufügt.

Beispiel fee_icann note object: 

{
    "feeIcann": {
        "pricetype": [
            "register",
            "renewal",
            "transfer"
        ],
        "amount": "0.18",
        "addedToListPrice": true
    }
}

Das Feld pricetype gibt an, bei welchen Preistypen die Gebühr anfällt, und das Feld addedToListPrice zeigt an, dass die Gebühr zum Endpreis hinzugefügt wurde.
notes.feeTax array of objects Gibt die verschiedenen Steuersätze an, die von einem Registrar erhoben werden, die Kunden, für die die Steuer gilt, und ob die berechnete Steuer im Endpreis für die TLD enthalten ist. Bitte beachten Sie, dass die Steuern nur dann im Endpreis für die TLD enthalten sind, wenn der Registrar die Steuer nicht in seine beworbenen Preise aufnimmt und die Steuer allen Kunden in Rechnung gestellt wird.

Beispiel feeTax Array von Objekten: 

{
    "feeTax": [
        {
            "addedToListPrice": false,
            "appliesToCustomers": [
                "eu",
                "us",
                "in"
            ],
            "amountRateType": "percent",
            "amountRate": "13",
            "type": "hst"
        },
        {
            "addedToListPrice": false,
            "appliesToCustomers": [
                "ca"
            ],
            "amountRateType": "percent",
            "amountRate": "5",
            "type": "gst"
        }
    ]
}
notes.feeTax[].type string Etikett, das die Art der Steuer beschreibt, d.h. 'vat' für Mehrwertsteuer, 'gst' für Goods and Services Tax, usw.
notes.feeTax[].amountRate number|string Betrag des Steuersatzes. Dabei handelt es sich entweder um den prozentualen Steuersatz als Zahl oder um die Zeichenfolge '~', die angibt, dass der Steuersatz je nach Kundenkriterium, wie z.B. dem Standort, variiert.
notes.feeTax[].amountRateType string Der String-Wert 'Prozent' zeigt an, dass der amountRate-Wert ein numerischer Prozentsatz ist. Der String-Wert 'percent-varies-by-location' zeigt an, dass der Steuersatz je nach Rechnungsregion oder Land des Kunden variiert.
notes.feeTax[].appliesToCustomers string|array of strings die Zeichenfolge '*' bedeutet, dass die Steuer für alle Kunden gilt. Andernfalls handelt es sich bei diesem Wert um ein Array von ISO 3166-1 Alpha-2-Ländercodes, die angeben, für welche Länder die Steuer gilt. Eine Ausnahme ist erwähnenswert: Das Array kann den Nicht-Ländercode-String 'eu' enthalten, der für alle Länder der Europäischen Union steht.
notes.feeTax[].addedToListPrice boolean Zeigt an, ob der berechnete Steuerbetrag zum Endpreis hinzugefügt wurde.
notes.feePayment object Gibt an, ob der Registrar eine zusätzliche Gebühr auf der Grundlage der Zahlungsmethode des Kunden erhebt und ob die Gebühr in den Endpreis für die TLD eingerechnet wurde.
Beispiel feePayment Objekt: 

{
    "feePayment": {
        "addedToListPrice": false,
        "amountRate": "~",
        "amountRateMin": "0.9",
        "amountRateMax": "20",
        "amountRateType": "percent-varies-by-method"
    }
}
notes.feePayment.amountRate string Gebührenbetrag. Hierbei handelt es sich entweder um den prozentualen Gebührensatz als Zahl oder um die Zeichenkette '~', die angibt, dass der Gebührensatz je nach Kundenkriterium, z. B. der Zahlungsmethode, variiert.
notes.feePayment.amountRateMin string Mindestbetrag der Gebühr, gilt nur, wenn die Gebühr variabel ist.
notes.feePayment.amountRateMax string Maximaler Gebührenbetrag, gilt nur, wenn die Gebühr variabel ist.
notes.feePayment.amountRateType string Der String-Wert 'Prozent' zeigt an, dass der amountRate-Wert ein numerischer Prozentsatz ist. Der String-Wert 'percent-varies-by-method' zeigt an, dass die Gebühr ein Prozentsatz ist, der je nach der Zahlungsmethode des Kunden variiert.
notes.feePayment.addedToListPrice boolean Zeigt an, ob der berechnete Gebührenbetrag zum Endpreis hinzugefügt wurde.
notes.currencyExchangeRate object Gibt an, dass die Preise des Registrars in einer anderen Landeswährung angegeben waren und in USD umgerechnet wurden. Die Details der Währungsumrechnung werden wie folgt dargestellt:

base: die Preiswährung des Registrars als 3-Buchstaben-Code (z.B. EUR)
quote: die Währung, in die die Preise umgerechnet wurden (wird immer USD sein)
rate: der Wechselkurs, der für die Währungsumrechnung verwendet wurde.

Beispiel für das Notizobjekt currencyExchangeRate: 

{
    "currencyExchangeRate": {
        "base": "GBP",
        "quote": "USD",
        "rate": "1.2482"
    }
}
threeYearValueScore number Ein numerisches Maß für den Wert, der sich aus dem Preis und den kostenlosen Funktionen für den Besitz einer Domain mit dieser Endung über den Registrar für einen Zeitraum von 3 Jahren ergibt. Je größer die Zahl, desto mehr Wert wird geboten.
currency string Der dreistellige ISO 4217-Währungscode der Preisdaten. Dieser Wert ist derzeit nur USD.
freeFeatures array of objects Ein Array von Objekten, die die kostenlosen Funktionen darstellen, die der Registrar mit dem Besitz einer Domain anbietet. Das Objekt enthält die Anzahl und die Dauer der einzelnen Funktionen. Jedes Objekt ist mit einer ID für die kostenlose Funktion verschlüsselt:

dns - kostenloser DNS-Dienst.
whois-privacy - WHOIS-Datenschutzdienst.
email-account - kostenlose(s) E-Mail-Konto(s).
email-forward - kostenlose E-Mail-Weiterleitung.
ssl-cert - kostenlose(s) Basis-SSL-Zertifikat(e).

Beispiel für eine kostenlose Funktion: 

[
    {
        "name": "dns"
    },
    {
        "name": "whois-privacy"
    },
    {
        "name": "email-account",
        "count": 5
    },
    {
        "name": "ssl-cert",
        "duration": 365
    }
]
freeFeatures[].count number Der Umfang der Funktion, die der Registrar kostenlos anbietet. Dieses Feld wird nicht angezeigt, wenn es nicht zutreffend ist.
freeFeatures[].duration number Die Anzahl der Tage, an denen die Funktion von der Registrierungsstelle kostenlos angeboten wird. Wenn die Dauer = 365 ist, dann wird die Funktion 1 Jahr lang kostenlos angeboten. Dieses Feld wird nicht angezeigt, wenn es nicht zutreffend ist.

RegistrarPromo

Beschreibt eine aktive Werbeaktion, die von einem Registrar angeboten wird. Beispiel: 

{
    "code": "MYCOUPONCODE",
    "amount": "20.00",
    "type": "discount-percent",
    "start": "2015-06-22T00:00:00",
    "end": "2025-06-22T00:00:00"
}
Pfad Typ Beschreibung
promo.code string Der Promo-Code, den der Kunde an der Kasse eingeben muss, um den Preisnachlass zu erhalten.
promo.amount string Der numerische Betrag des Aktionspreises. Je nach Art der Werbeaktion kann dies der ermäßigte Preis(Preis), der vom regulären Preis abgezogene Betrag(Rabatt) oder der vom regulären Preis abgezogene prozentuale Betrag(Rabatt-Prozent) sein.
promo.type string Eine Zeichenfolge, die die Art der Preisaktion angibt. Es handelt sich um einen der folgenden Werte:

price - bedeutet, dass das Betragsfeld der Werbeaktion der neue ermäßigte Preis ist
discount - bedeutet, dass das Betragsfeld der Werbeaktion vom regulären Preis subtrahiert wurde, um den angewandten Preis zu erhalten
discount-percent - bedeutet, dass das Betragsfeld der Werbeaktion ein Prozentsatz ist und der Prozentsatz vom regulären Preis subtrahiert wurde, um den angewandten Preis zu erhalten.
promo.start string ISO 8601-Datum (UTC-Zeitzone) des Beginns der Werbeaktion. Wird nicht angezeigt, wenn es kein bestimmtes Startdatum gibt. Beispiel: 2015-06-22T00:00:00
promo.end string ISO 8601-Datum (UTC-Zeitzone) für das Ende der Werbeaktion. Wird nicht angezeigt, wenn es kein bestimmtes Enddatum gibt. Beispiel: 2025-06-22T00:00:00
promo.pricetype array of strings Der/die Preistyp(en), für den/die die Werbeaktion gilt: register, renewal, transfer.

Hinweis: Dieses Feld ist nur vorhanden, wenn es im Kontext eines Preistyps verschachtelt ist (zum Beispiel in der Antwort von getCheapestRegistrars).

Fehler-Codes

Wenn eine Anfrage fehlschlägt, kann das JSON-Antwortobjekt ein oder mehrere Fehlerobjekte enthalten, die beschreiben, was falsch gelaufen ist. Nachfolgend finden Sie eine nicht vollständige Liste der identifizierenden Fehlercodes, die in das Codefeld des Fehlerobjekts eingegeben werden können.

Code Beschreibung
502 Der API-Server ist vorübergehend nicht verfügbar.
RATE_LIMITED Die Anzahl der Client-API-Anfragen hat das zulässige Maximum überschritten.
INVALID_METHOD Die angeforderte API-Methode existiert nicht.
SYSTEM Ein unbekannter Systemfehler ist aufgetreten.
RESPONSE_TIMEOUT Der API-Server hat eine Zeitüberschreitung bei der Generierung einer Antwort.
PARAMETER_REQUIRED Ein erforderlicher Parameter für die aufgerufene Methode wurde vom Client nicht bereitgestellt.
ACCOUNT_INACTIVE Das Konto des Kunden ist nicht mehr aktiv und für den API-Zugang ist eine Abonnementverlängerung erforderlich.
NO_ACCESS Die Kontoebene des Kunden gewährt keinen API-Zugang. Für den API-Zugang ist ein Konto-Upgrade erforderlich.
AUTH_INVALID Authentifizierung fehlgeschlagen: Die angegebenen API-Schlüssel sind inaktiv oder ungültig.
CLIENT_IPS_EXCEEDED Die maximale Anzahl eindeutiger Client-IPs, die für den Zugriff auf die API für das angegebene API-Schlüsselpaar zugelassen sind, wurde überschritten.
REQUEST_ENDED_BY_CLIENT Die Anfrage wurde vom Client abgebrochen, bevor eine Antwort generiert werden konnte.

Grenzwerte

Die Nutzung der API unterliegt bestimmten Beschränkungen, um Missbrauch zu verhindern. Diese Nutzungsbeschränkungen sind unten aufgeführt und können ohne vorherige Ankündigung geändert werden.

Typ Beschreibung
API-Schlüssel pro Konto 3
Rate Limit 100 Maximale Anfragen pro 15 Minuten
Client-IP-Adressen pro API-Schlüssel 5 eindeutige Client-IP-Adressen pro Schlüssel pro 1440 Minuten

Erweiterungsmethoden

get

Gibt Endungen und die zugehörigen Preis- und Detaildaten zurück. Diese Methode entspricht dem Abrufen der Daten, die auf einer oder mehreren TLD-Detailseiten (z.B. .com) angezeigt werden, mit Ausnahme der Daten zum "günstigsten Preisverlauf", die von dieser Methode nicht zurückgegeben werden (siehe die Methode getAggregateHistory für historische Daten).

API-Endpunkt:https://api.tld-list.com/v1/extension/get

Reaktionszeit:~12 seconds for all extensions, ~6 seconds < 2000 extensions, ~2 seconds < 100 extensions

Parameter anfordern

Schlüssel Typ Erforderlich Beschreibung
extensions array of strings

Gibt an, welche Erweiterungen abgerufen werden sollen. Fügen Sie keinen vorangestellten Punkt ein. Die Namen der Erweiterungen können Unicode oder ihr Punycode-Äquivalent sein. Wenn Sie nichts angeben, werden alle auf TLD-List aufgeführten Erweiterungen zurückgegeben.

Beispiel: "extensions": ["com", "io", "co.uk", "移动", "xn--p1ai"]
includeFields array of strings Geben Sie bestimmte Daten, die zurückgegeben werden sollen, über den Schlüsselnamen an. Schlüssel, die nicht in diesem Parameter angegeben werden, werden ausgelassen. Standardmäßig werden alle verfügbaren Felder zurückgegeben. In der Antworttabelle finden Sie eine Liste der verfügbaren Felder. Verschachtelte Felder werden nicht unterstützt.

Beispiel: "includeFields": ["name", "registrars", "dnssecSupported"]
excludeFields array of strings Geben Sie die auszuschließenden Cetain-Daten nach Schlüsselnamen an. Schlüssel, die in diesem Parameter angegeben werden, werden ausgelassen. Standardmäßig werden keine Felder ausgeschlossen. In der Antworttabelle finden Sie eine Liste der verfügbaren Felder. Verschachtelte Felder werden nicht unterstützt.

Beispiel: "excludeFields": ["available", "syntax", "sponsor"]
includeRegistrars array of strings

Die IDs der aktiven Registrierstellen, die in die Ergebnisse aufgenommen werden sollen. Verwenden Sie die Methode getIds, um eine Liste der IDs aller Registrierstellen zu erhalten, die aktiv auf TLD-List aufgeführt sind.

Beispiel: "includeRegistrars": ["godaddy", "porkbun", "namecheap"]
excludeRegistrars array of strings

Die IDs der aktiven Registrierstellen, die in den Ergebnissen ausgeschlossen werden sollen. Verwenden Sie die Methode getIds, um eine Liste der IDs aller Registrierstellen zu erhalten, die aktiv auf TLD-List aufgeführt sind.

Beispiel: "excludeRegistrars": ["godaddy", "porkbun", "namecheap"]
omitExtensionsWithoutRegistrars boolean

Wenn Sie true wählen, werden Erweiterungen, die in den Ergebnissen keine Preisdaten des Registrars enthalten, ausgelassen. Standardmäßig werden alle Erweiterungen berücksichtigt.

Beispiel: "omitExtensionsWithoutRegistrars": true

Antwort-Objekt

Pfad Typ Beschreibung
data array of objects Array mit Namen von Erweiterungen.
data[].available object Objekt der TLD-Phasenverfügbarkeitsdaten.
data[].available.general object ISO 8601-Datum (UTC-Zeitzone), ab dem die Domainregistrierung für die Allgemeinheit verfügbar ist.
data[].available.sunrise object Objekt mit Start- und Enddatum, das die TLD's Sunrise-Phase repräsentiert (ab der Markeninhaber die Registrierung der entsprechenden Domains beantragen können). Beispiel: 

{
    "sunrise": {
        "start": "2017-06-19T00:00:00.000Z",
        "end": "2017-08-21T00:00:00.000Z"
    }
}
data[].available.trademark object Objekt mit Start- und Endzeitbereichen, die die TLD's Markenphase darstellen (Zeitraum, in dem Markeninhaber vom Trademark Clearinghouse benachrichtigt werden, wenn eine Domain mit ihrer Marke registriert wird). Beispiel: 

{
    "trademark": {
        "start": "2019-06-18T00:00:00.000Z",
        "end": "2020-09-21T00:00:00.000Z"
    }
}
data[].available.other array of objects Array von Objekten, die verschiedene Startphasen der TLD und ihre Datumsbereiche darstellen, z.B. "Land Rush" und "Qualified Launch Program". Beispiel: 

{
    "other": [
        {
            "end": "2020-09-18T00:00:00.000Z",
            "name": "Limited Community Priority Period",
            "start": "2019-09-17T00:00:00.000Z",
            "type": "limited-registration-period"
        },
        {
            "end": "2018-07-03T00:00:00.000Z",
            "name": "Restricted Land Rush 1",
            "start": "2017-10-23T00:00:00.000Z",
            "type": "limited-registration-period"
        },
        {
            "end": "2019-09-16T00:00:00.000Z",
            "name": "Invitation Priority Access",
            "start": "2017-08-22T00:00:00.000Z",
            "type": "limited-registration-period"
        },
        {
            "end": "2017-08-21T00:00:00.000Z",
            "name": "Qualified Launch Program",
            "start": "2017-06-19T00:00:00.000Z",
            "type": "qualified-launch-program"
        }
    ]
}
data[].average object Objekt, das den durchschnittlichen Preis der Erweiterung nach Preistyp für die eingeschlossenen Registrierstellen enthält. Beispiel: 

{
    "average": {
        "register": "7.63",
        "renewal": "13.63",
        "transfer": "9.63"
    }
}
data[].average[pricetype] string Der Durchschnittspreis der Erweiterung als numerische Zeichenfolge für [pricetype], wobei der Schlüssel [pricetype] register, renewal, transfer, restore, whoisprivacy lautet.
data[].category string Die Kategorien, unter denen die TLD klassifiziert wurde. Jedes Objekt in dem Array steht für eine Kategorie und enthält die folgenden Felder:

id - ganzzahlige Kategorie-ID, die intern von TLD-List verwendet wird.
idstr - alternative String-Kategorie-ID.
name - Kategoriename auf Englisch.
desc - Kategoriebeschreibung auf Englisch.

Beispiel für ein Kategorie-Array: 

[
    {
        "id": 4,
        "idstr": "services",
        "name": "Services",
        "desc": "TLDs for representing the service industry."
    },
    {
        "id": 6,
        "idstr": "food",
        "name": "Food & Drink",
        "desc": "Domain extensions for dining, cooking, restaurants, and beverages."
    }
]
data[].dnssecSupported boolean Wenn die DNS-Zone der Registry DNS Security Extensions (DNSSEC) unterstützt.
data[].hasPremiumDomains object Objekt mit [pricetype]-Schlüsseln und booleschen Werten, die angeben, ob das Register höhere Preise für bestimmte "Premium"-Domainnamen verlangt. Beispiel: 

{
    "hasPremiumDomains": {
        "register": false,
        "renewal": false
    }
}
data[].infoUpdated string ISO 8601 Datumszeitpunkt (UTC-Zeitzone), wann die Basisinformationen von TLD's (Einschränkungen, Verfügbarkeitsdaten usw.) zuletzt überprüft und aktualisiert wurden. Hinweis: Ein neues updated.info-Datum bedeutet nicht notwendigerweise, dass eine Datenänderung stattgefunden hat. Es zeigt nur an, wann die Daten zuletzt geprüft und eingestellt wurden.
data[].intendedUsage string Allgemeine Informationen darüber, wie die Erweiterung von den Registranten verwendet werden soll.
data[].language string Der ISO 639-1 Sprachcode mit 2 Zeichen. Wenn die Sprache auf Englisch basiert oder unbekannt ist, wird dieses Feld nicht ausgefüllt.
data[].level integer Integerwert, der die Domänenebene der Erweiterung angibt. 1 = Top-Level-Domain, 2 = Second-Level-Domain, 3 = Third-Level-Domain, usw.
data[].localPresenceRequired boolean Wenn das Register verlangt, dass der Registrant eine physische Adresse in der Region hat.
data[].median object Objekt, das den mittleren Preis der Erweiterung nach Preistyp für die einbezogenen Registrierstellen enthält. Beispiel: 

{
    "median": {
        "register": "3.17",
        "renewal": "20.17",
        "transfer": "8.17"
    }
}
data[].median[pricetype] string Der Medianpreis der Erweiterung als numerische Zeichenfolge für [pricetype], wobei der Schlüssel [pricetype] register, renewal, transfer, restore, whoisprivacy lautet.
data[].name string Unicode-Name der Domänenerweiterung.
data[].nameservers array Die Root-Nameserver der Registry, die die maßgeblichen Nameserver der registrierten Domains speichern. Beispiel Nameserver-Array: 

{
    "nameservers": [
        {
            "host": "a.gtld-servers.net",
            "ipv4": "192.5.6.30",
            "ipv6": "2001:503:a83e:0:0:0:2:30"
        },
        {
            "host": "b.gtld-servers.net",
            "ipv4": "192.33.14.30",
            "ipv6": "2001:503:231d:0:0:0:2:30"
        }
    ]
}
data[].parentTld string Die übergeordnete Top-Level-Domain der Erweiterung. Wenn es sich um eine TLD handelt, ist dieses Feld nicht vorhanden.
data[].pricingUpdated string ISO 8601 Datumszeitpunkt (UTC-Zeitzone), an dem die Preise des TLD's Registrars zuletzt überprüft und aktualisiert wurden. Hinweis: Ein neues updated.pricing-Datum bedeutet nicht unbedingt, dass eine Datenänderung stattgefunden hat. Es zeigt nur an, wann die Daten zuletzt geprüft und festgelegt wurden.
data[].punycode string Punycode-Name der Domainendung. Nur bei IDN-Erweiterungen vorhanden.
data[].registerMaxYears integer Maximale Jahre, die eine Domain zum Zeitpunkt des Kaufs registriert werden kann.
data[].registerMinYears integer Mindestjahre, die eine Domain zum Zeitpunkt des Kaufs registriert werden kann.
data[].registrarsIncluded integer Anzahl der Registrare, die im zurückgegebenen Array registrars enthalten sind.
data[].registrarsTotal integer Gesamtzahl der aktiven Registrare, die die Erweiterung verkaufen.
data[].registrars array of objects Array von RegistrarPricing-Objekten, die Daten zu Preisen und Funktionen des Registrars enthalten.
data[].registryUrl string Die offizielle Website des Registers für Informationen zur TLD-Registrierung.
data[].renewalMinYears integer Minimale Anzahl von Jahren, die eine Domain verlängert werden kann.
data[].restrictions string Eine kurze Beschreibung der TLD's Registrierungsbeschränkungen und -anforderungen. Wenn es keine Einschränkungen gibt, wird dieses Feld nicht ausgefüllt.
data[].sponsor object Objekt mit Daten über die Trägerorganisation oder die Verwaltungsorganisation der Erweiterung.
data[].sponsor.name string Der Name der von der ICANN zugelassenen Trägerorganisation oder der ccTLD Verwaltungsorganisation der Erweiterung.
data[].sponsor.address string Physischer Standort der Trägerorganisation oder der ccTLD Verwaltungsorganisation. Beispiel für ein Adressfeld: 

{
    "sponsor": {
        "address": [
            "Minerva House",
            "Edmund Halley Road",
            "Oxford Science Park",
            "Oxford OX4 4DQ",
            "United Kingdom"
        ]
    }
}
data[].sponsorParentCompany string Name des Unternehmens, das eine Mehrheitsbeteiligung an der Sponsororganisation besitzt.
data[].romanized string Die TLD in lateinische Buchstaben umgewandelt. Wenn die Sprache auf Englisch basiert oder unbekannt ist, wird dieses Feld nicht angezeigt.
data[].rtl string Wenn die Erweiterung von "rechts nach links" gelesen wird (z.B. Arabric TLDs), ist dieser Wert __true__. Wenn sie von "links nach rechts" gelesen wird, ist dieser Wert __false__. Wenn der Wert unbekannt ist, wird er nicht angezeigt.
data[].syntax object Objekt mit Details zu den Regeln und Beschränkungen für erlaubte Domainnamen der Erweiterung.
data[].syntax.minChars integer Mindestanzahl der Zeichen, die ein Etikett enthalten muss, um registriert zu werden.
data[].syntax.maxChars integer Maximale Anzahl von Zeichen in einem Etikett, die registriert werden können.
data[].targetMarket string Die Personen oder Einrichtungen, für die die TLD gedacht ist.
data[].translation string Die englische Übersetzung der TLD. Wenn die TLD bereits auf Englisch basiert oder die Übersetzung unbekannt ist, wird dieser Wert nicht angezeigt.
data[].type string Der Typ der TLD, der durch eine der folgenden Zeichenfolgen identifiziert wird:

gTLD: generische Top-Level-Domain.
ccTLD : länderspezifische Top-Level-Domain.
grTLD: generisch eingeschränkte Top-Level-Domain.
sTLD: gesponserte Top-Level-Domain.
data[].wholesale object Objekt mit den Großhandelspreisen der Erweiterung nach Preistyp. Großhandelspreise sind die Preise, die das Register einem Registrar für den Kauf von Domänennamen in Rechnung stellt. Beispiel: 

{
    "wholesale": {
        "register": "8.97",
        "renewal": "8.97",
        "transfer": "8.97"
    }
}
data[].whoisPrivacySupported boolean Wenn die Erweiterung WHOIS Privacy Services erlaubt, die Namen und Kontaktinformationen der Registranten zu maskieren. Falls nicht, ist dieses Feld nicht vorhanden.
data[].whoisServer boolean Hostname des Servers der Registrierungsstelle, auf dem die Kontaktinformationen des Domänenregistrierenden gespeichert sind.

Beispiel Anfrage/Antwort

curl -X POST https://api.tld-list.com/v1/extension/get -H 'Content-Type: application/json' -d '{"extensions": ["com"], "includeRegistrars": ["porkbun","godaddy","epik"], "apiKeyPublic":"MY_PUBLIC_KEY","apiKeyPrivate":"MY_PRIVATE_KEY"}'

{
   "data" : [
      {
         "average" : {
            "register" : "7.63",
            "renewal" : "13.63",
            "transfer" : "9.63"
         },
         "clicks" : 226,
         "dnssecSupported" : true,
         "hasPremiumDomains" : {
            "register" : false,
            "renewal" : false
         },
         "infoUpdated" : "2023-02-04T11:05:09",
         "level" : 1,
         "localPresenceRequired" : false,
         "median" : {
            "register" : "3.17",
            "renewal" : "20.17",
            "transfer" : "8.17"
         },
         "name" : "com",
         "nameservers" : [
            {
               "host" : "a.gtld-servers.net",
               "ipv4" : "192.5.6.30",
               "ipv6" : "2001:503:a83e:0:0:0:2:30"
            },
            {
               "host" : "b.gtld-servers.net",
               "ipv4" : "192.33.14.30",
               "ipv6" : "2001:503:231d:0:0:0:2:30"
            },
            {
               "host" : "c.gtld-servers.net",
               "ipv4" : "192.26.92.30",
               "ipv6" : "2001:503:83eb:0:0:0:0:30"
            },
            {
               "host" : "d.gtld-servers.net",
               "ipv4" : "192.31.80.30",
               "ipv6" : "2001:500:856e:0:0:0:0:30"
            },
            {
               "host" : "e.gtld-servers.net",
               "ipv4" : "192.12.94.30",
               "ipv6" : "2001:502:1ca1:0:0:0:0:30"
            },
            {
               "host" : "f.gtld-servers.net",
               "ipv4" : "192.35.51.30",
               "ipv6" : "2001:503:d414:0:0:0:0:30"
            },
            {
               "host" : "g.gtld-servers.net",
               "ipv4" : "192.42.93.30",
               "ipv6" : "2001:503:eea3:0:0:0:0:30"
            },
            {
               "host" : "h.gtld-servers.net",
               "ipv4" : "192.54.112.30",
               "ipv6" : "2001:502:8cc:0:0:0:0:30"
            },
            {
               "host" : "i.gtld-servers.net",
               "ipv4" : "192.43.172.30",
               "ipv6" : "2001:503:39c1:0:0:0:0:30"
            },
            {
               "host" : "j.gtld-servers.net",
               "ipv4" : "192.48.79.30",
               "ipv6" : "2001:502:7094:0:0:0:0:30"
            },
            {
               "host" : "k.gtld-servers.net",
               "ipv4" : "192.52.178.30",
               "ipv6" : "2001:503:d2d:0:0:0:0:30"
            },
            {
               "host" : "l.gtld-servers.net",
               "ipv4" : "192.41.162.30",
               "ipv6" : "2001:500:d937:0:0:0:0:30"
            },
            {
               "host" : "m.gtld-servers.net",
               "ipv4" : "192.55.83.30",
               "ipv6" : "2001:501:b1f9:0:0:0:0:30"
            }
         ],
         "pricingUpdated" : "2023-02-04T11:04:33",
         "registerMaxYears" : 10,
         "registerMinYears" : 1,
         "registrars" : [
            {
               "currency" : "USD",
               "freeFeatures" : [
                  {
                     "name" : "dns"
                  },
                  {
                     "name" : "whois-privacy"
                  }
               ],
               "id" : "godaddy",
               "name" : "GoDaddy",
               "notes" : {
                  "feeIcann" : {
                     "addedToListPrice" : true,
                     "amount" : "0.18",
                     "pricetype" : [
                        "register",
                        "renewal",
                        "transfer"
                     ]
                  },
                  "feeTax" : [
                     {
                        "addedToListPrice" : false,
                        "amountRate" : "~",
                        "amountRateType" : "percent-varies-by-location",
                        "appliesToCustomers" : [
                           "eu"
                        ],
                        "type" : "vat"
                     },
                     {
                        "addedToListPrice" : false,
                        "amountRate" : "15",
                        "amountRateType" : "percent",
                        "appliesToCustomers" : [
                           "in"
                        ],
                        "type" : "gst"
                     },
                     {
                        "addedToListPrice" : false,
                        "amountRate" : "10",
                        "amountRateType" : "percent",
                        "appliesToCustomers" : [
                           "au"
                        ],
                        "type" : "gst"
                     }
                  ]
               },
               "prices" : {
                  "register" : "3.17",
                  "renewal" : "20.17",
                  "transfer" : "8.17",
                  "whoisPrivacy" : "0.00"
               },
               "pricesOriginal" : {
                  "register" : "10.18"
               },
               "promos" : [
                  {
                     "amount" : "2.99",
                     "code" : "GDD2dom",
                     "pricetype" : [
                        "register"
                     ],
                     "start" : "2023-01-01T00:00:00",
                     "type" : "price"
                  }
               ],
               "terms" : {
                  "limitPerCustomer" : {
                     "count" : 1,
                     "pricetype" : [
                        "register"
                     ]
                  }
               },
               "threeYearValueScore" : "5.76"
            },
            {
               "currency" : "USD",
               "freeFeatures" : [
                  {
                     "name" : "whois-privacy"
                  },
                  {
                     "name" : "dns"
                  }
               ],
               "id" : "epik",
               "name" : "Epik",
               "prices" : {
                  "register" : "9.99",
                  "renewal" : "10.99",
                  "restore" : "90.00",
                  "transfer" : "9.99",
                  "whoisPrivacy" : "0.00"
               },
               "threeYearValueScore" : "8.29"
            },
            {
               "currency" : "USD",
               "freeFeatures" : [
                  {
                     "name" : "whois-privacy"
                  },
                  {
                     "name" : "dns"
                  },
                  {
                     "name" : "email-forward"
                  },
                  {
                     "name" : "ssl-cert"
                  }
               ],
               "id" : "porkbun",
               "name" : "Porkbun",
               "prices" : {
                  "register" : "8.73",
                  "renewal" : "9.73",
                  "transfer" : "9.73",
                  "whoisPrivacy" : "0.00"
               },
               "pricesOriginal" : {
                  "register" : "9.73"
               },
               "promos" : [
                  {
                     "amount" : "1.00",
                     "code" : "AWESOMENESS",
                     "pricetype" : [
                        "register"
                     ],
                     "type" : "discount"
                  }
               ],
               "terms" : {
                  "limitPerCustomer" : {
                     "count" : 1,
                     "pricetype" : [
                        "register"
                     ]
                  }
               },
               "threeYearValueScore" : "16.03"
            }
         ],
         "registryUrl" : "http://www.verisigninc.com",
         "renewalMinYears" : 1,
         "rtl" : false,
         "sponsor" : {
            "address" : [
               "12061 Bluemont Way",
               "Reston Virginia 20190",
               "United States"
            ],
            "name" : "VeriSign Global Registry Services"
         },
         "syntax" : {
            "maxChars" : 63,
            "minChars" : 2
         },
         "type" : "gTLD",
         "whoisPrivacySupported" : true,
         "whoisServer" : "whois.verisign-grs.com",
         "wholesale" : {
            "register" : "8.97",
            "renewal" : "8.97",
            "transfer" : "8.97"
         }
      }
   ],
   "errors" : [],
   "seconds" : 0.068,
   "status" : "SUCCESS"
}

getNames

Liefert alle Erweiterungsnamen.

API-Endpunkt:https://api.tld-list.com/v1/extension/getNames

Reaktionszeit:~1 second

Parameter anfordern

Schlüssel Typ Erforderlich Beschreibung
omitExtensionsWithoutRegistrars boolean Bei true werden Erweiterungen, die keine Preisdaten des Registrars in den Ergebnissen haben, ausgelassen. Die Voreinstellung ist false.
wantPunycode boolean Kodiert alle zurückgegebenen IDN-Erweiterungen als Punycode anstelle von Unicode. Die Voreinstellung ist false.

Antwort-Objekt

Pfad Typ Beschreibung
data array of strings Array mit Namen von Erweiterungen.

Beispiel Anfrage/Antwort

curl -X POST https://api.tld-list.com/v1/extension/getNames -H 'Content-Type: application/json' -d '{"apiKeyPublic":"MY_PUBLIC_KEY","apiKeyPrivate":"MY_PRIVATE_KEY", "wantPunycode": true, "omitExtensionsWithoutRegistrars": true}'

{
   "data" : [
      "2000.hu",
      "5g.in",
      "6g.in",
      "aaa.pro",
      "abc.br",
      "abkhazia.su",
      "abo.pa",
      "abogado",
      "abr.it",
      "abruzzo.it",
      "abudhabi",
      ...
      "xn--3bst00m",
      "xn--jvr189m",
      "xn--imr513n",
      "xn--j6w193g",
      "xn--t60b56a",
      "xn--mk1bu44c",
      "xn--3e0b707e"
   ],
   "errors" : [],
   "seconds" : 0.697,
   "status" : "SUCCESS"
}

getCheapestRegistrar

Liefert die günstigsten Registrare/Provider, ihre Preise, den Medianpreis und den Durchschnittspreis pro Domainendung. Erweiterungen, die von keinem Registrar verkauft werden, werden nicht zurückgegeben.

API-Endpunkt:https://api.tld-list.com/v1/extension/getCheapestRegistrar

Reaktionszeit:~8 seconds for all extensions, ~4 seconds < 2000 extensions, ~1 second < 100 extensions

Parameter anfordern

Schlüssel Typ Erforderlich Beschreibung
pricetypes array of strings

Gibt an, welche Arten von Preisen abgerufen werden sollen. Wenn Sie nichts angeben, werden 3 Preistypen (register, renewal, transfer) zurückgegeben.

Beispiel: "pricetypes": ["register", "transfer"]
extensions array of strings

Gibt an, welche Erweiterungen abgerufen werden sollen. Fügen Sie keinen vorangestellten Punkt ein. Die Namen der Erweiterungen können Unicode oder ihr Punycode-Äquivalent sein. Wenn Sie nichts angeben, werden alle auf TLD-List aufgeführten Erweiterungen zurückgegeben.

Beispiel: "extensions": ["com", "io", "co.uk", "移动", "xn--p1ai"]
includeRegistrars array of strings

Die String-IDs aktiver Registrare, die bei der Ermittlung der günstigsten Preise und der Aggregatberechnungen berücksichtigt werden sollen. Registrierstellen, die nicht in diesem Parameter angegeben sind, werden ignoriert. Verwenden Sie die Methode getIds, um eine Liste der IDs aller Registrierstellen zu erhalten, die aktiv auf TLD-List gelistet sind.

Wenn Sie diesen Parameter nicht angeben, werden alle Registrierstellen, die aktiv auf TLD-List gelistet sind, berücksichtigt.

Beispiel: "includeRegistrars": ["godaddy", "porkbun", "namecheap"]
excludeRegistrars array of strings

Die String-IDs aktiver Registrierstellen, die bei der Ermittlung der günstigsten Preise und bei der Berechnung der Aggregate ausgeschlossen werden sollen. Verwenden Sie die Methode getIds, um eine Liste der IDs aller Registrierstellen zu erhalten, die aktiv auf TLD-List gelistet sind.

Wenn dieser Parameter nicht angegeben wird, werden keine Registrierstellen ignoriert.

Beispiel: "excludeRegistrars": ["godaddy", "porkbun", "namecheap"]
omitExtensionsWithoutRegistrars boolean

Bei true werden Erweiterungen, die keine Registrar-Preisdaten in den Ergebnissen haben, ausgelassen. Diese Situation tritt ein, wenn die übergebenen Parameter excludeRegistrars und/oder includeRegistrars dazu geführt haben, dass eine Nebenstelle, die normalerweise über Registrierstellen-Preisdaten verfügt, keine passenden Registrierstellen-Preisdaten hat. Diese Erweiterungen sind standardmäßig enthalten, allerdings mit leeren Arrays für ihre Preisdaten. Setzen Sie diesen Parameter auf true, um diese Erweiterungen aus den Ergebnissen auszuschließen.

Beispiel: "omitExtensionsWithoutRegistrars": true

Antwort-Objekt

Pfad Typ Beschreibung
data array of objects Array von Objekten, die jeweils eine Domänenerweiterung darstellen.
data[].name string Unicode-Name der Domänenerweiterung.
data[].punycode string Punycode-Name der Domainendung. Nur bei IDN-Erweiterungen vorhanden.
data[].currency string Der dreistellige ISO 4217-Währungscode der Preisdaten. Dieser Wert ist derzeit nur USD.
data[].registrarsIncluded number Anzahl der Registrierstellen, die in den zurückgegebenen Preisdaten enthalten sind.
data[].average object Objekt, das den Durchschnittspreis der Erweiterung nach Preistyp für die einbezogenen Registrierstellen enthält.
data[].average[pricetype] string Der Durchschnittspreis der Erweiterung als numerische Zeichenfolge für [pricetype], wobei der Schlüssel [pricetype] register, renewal, transfer lautet.
data[].median object Objekt, das den mittleren Preis der Erweiterung nach Preistyp für die einbezogenen Registrierstellen enthält.
data[].median[pricetype] string Der Medianpreis der Erweiterung als numerische Zeichenfolge für [pricetype], wobei der Schlüssel [pricetype] register, renewal, transfer lautet.
data[].cheapest object Objekt mit den günstigsten Registrierstellen für die Erweiterung nach Preistyp.
data[].cheapest[pricetype] array of objects

Array von RegistrarPricing-Objekten mit den günstigsten Registraren nach [pricetype], wobei der Schlüssel [pricetype] register, renewal, transfer lautet.

Bei diesen Daten handelt es sich um ein Array, da der günstigste Preis für die Erweiterung bei mehreren Registrierstellen derselbe sein kann.

Beispiel Anfrage/Antwort

curl -X POST https://api.tld-list.com/v1/extension/getCheapestRegistrar -H 'Content-Type: application/json' -d '{"apiKeyPublic":"MY_PUBLIC_KEY","apiKeyPrivate":"MY_PRIVATE_KEY", "includeRegistrars": ["godaddy", "namecheap", "porkbun", "namesilo", "netim"], "extensions": ["com", "co.uk"]}'

{
   "data" : [
      {
         "average" : {
            "register" : "7.85",
            "renewal" : "10.25",
            "transfer" : "11.99"
         },
         "cheapest" : {
            "register" : [
               {
                  "currency" : "USD",
                  "freeFeatures" : [
                     {
                        "name" : "dns"
                     },
                     {
                        "name" : "email-forward"
                     },
                     {
                        "name" : "ssl-cert"
                     }
                  ],
                  "id" : "porkbun",
                  "name" : "Porkbun",
                  "price" : "4.96",
                  "priceOriginal" : "5.96",
                  "prices" : {
                     "register" : "4.96",
                     "renewal" : "5.96"
                  },
                  "pricesOriginal" : {
                     "register" : "5.96"
                  },
                  "pricetype" : "register",
                  "promo" : {
                     "amount" : "1.00",
                     "code" : "AWESOMENESS",
                     "type" : "discount"
                  },
                  "promos" : [
                     {
                        "amount" : "1.00",
                        "code" : "AWESOMENESS",
                        "type" : "discount"
                     }
                  ],
                  "terms" : {
                     "limitPerCustomer" : {
                        "count" : 1
                     }
                  },
                  "threeYearValueScore" : "18.36"
               }
            ],
            "renewal" : [
               {
                  "currency" : "USD",
                  "freeFeatures" : [
                     {
                        "name" : "dns"
                     },
                     {
                        "name" : "email-forward"
                     },
                     {
                        "name" : "ssl-cert"
                     }
                  ],
                  "id" : "porkbun",
                  "name" : "Porkbun",
                  "price" : "5.96",
                  "prices" : {
                     "register" : "4.96",
                     "renewal" : "5.96"
                  },
                  "pricetype" : "renewal",
                  "threeYearValueScore" : "18.36"
               }
            ],
            "transfer" : [
               {
                  "currency" : "USD",
                  "freeFeatures" : [
                     {
                        "name" : "dns"
                     }
                  ],
                  "id" : "godaddy",
                  "name" : "GoDaddy",
                  "notes" : {
                     "feeTax" : [
                        {
                           "addedToListPrice" : false,
                           "amountRate" : "~",
                           "amountRateType" : "percent-varies-by-location",
                           "appliesToCustomers" : [
                              "eu"
                           ],
                           "type" : "vat"
                        },
                        {
                           "addedToListPrice" : false,
                           "amountRate" : "15",
                           "amountRateType" : "percent",
                           "appliesToCustomers" : [
                              "in"
                           ],
                           "type" : "gst"
                        },
                        {
                           "addedToListPrice" : false,
                           "amountRate" : "10",
                           "amountRateType" : "percent",
                           "appliesToCustomers" : [
                              "au"
                           ],
                           "type" : "gst"
                        }
                     ]
                  },
                  "price" : "11.99",
                  "prices" : {
                     "register" : "6.49",
                     "renewal" : "11.99",
                     "transfer" : "11.99"
                  },
                  "pricetype" : "transfer",
                  "threeYearValueScore" : "3.46"
               }
            ]
         },
         "currency" : "USD",
         "median" : {
            "register" : "6.48",
            "renewal" : "10.78",
            "transfer" : "11.99"
         },
         "name" : "co.uk",
         "registrarsIncluded" : 4,
         "registrarsTotal" : 47
      },
      {
         "average" : {
            "register" : "8.90",
            "renewal" : "14.10",
            "transfer" : "9.30"
         },
         "cheapest" : {
            "register" : [
               {
                  "currency" : "USD",
                  "freeFeatures" : [
                     {
                        "name" : "dns"
                     },
                     {
                        "name" : "whois-privacy"
                     }
                  ],
                  "id" : "godaddy",
                  "name" : "GoDaddy",
                  "notes" : {
                     "feeIcann" : {
                        "addedToListPrice" : true,
                        "amount" : "0.18"
                     },
                     "feeTax" : [
                        {
                           "addedToListPrice" : false,
                           "amountRate" : "~",
                           "amountRateType" : "percent-varies-by-location",
                           "appliesToCustomers" : [
                              "eu"
                           ],
                           "type" : "vat"
                        },
                        {
                           "addedToListPrice" : false,
                           "amountRate" : "15",
                           "amountRateType" : "percent",
                           "appliesToCustomers" : [
                              "in"
                           ],
                           "type" : "gst"
                        },
                        {
                           "addedToListPrice" : false,
                           "amountRate" : "10",
                           "amountRateType" : "percent",
                           "appliesToCustomers" : [
                              "au"
                           ],
                           "type" : "gst"
                        }
                     ]
                  },
                  "price" : "3.17",
                  "priceOriginal" : "10.18",
                  "prices" : {
                     "register" : "3.17",
                     "renewal" : "20.17",
                     "transfer" : "8.17",
                     "whoisPrivacy" : "0.00"
                  },
                  "pricesOriginal" : {
                     "register" : "10.18"
                  },
                  "pricetype" : "register",
                  "promo" : {
                     "amount" : "2.99",
                     "code" : "GDD2dom",
                     "start" : "2023-01-01T00:00:00",
                     "type" : "price"
                  },
                  "promos" : [
                     {
                        "amount" : "2.99",
                        "code" : "GDD2dom",
                        "start" : "2023-01-01T00:00:00",
                        "type" : "price"
                     }
                  ],
                  "terms" : {
                     "limitPerCustomer" : {
                        "count" : 1
                     }
                  },
                  "threeYearValueScore" : "5.76"
               }
            ],
            "renewal" : [
               {
                  "currency" : "USD",
                  "freeFeatures" : [
                     {
                        "name" : "whois-privacy"
                     },
                     {
                        "name" : "dns"
                     },
                     {
                        "name" : "email-forward"
                     },
                     {
                        "name" : "ssl-cert"
                     }
                  ],
                  "id" : "porkbun",
                  "name" : "Porkbun",
                  "price" : "9.73",
                  "prices" : {
                     "register" : "8.73",
                     "renewal" : "9.73",
                     "transfer" : "9.73",
                     "whoisPrivacy" : "0.00"
                  },
                  "pricetype" : "renewal",
                  "threeYearValueScore" : "16.03"
               }
            ],
            "transfer" : [
               {
                  "currency" : "USD",
                  "freeFeatures" : [
                     {
                        "name" : "dns"
                     },
                     {
                        "name" : "whois-privacy"
                     },
                     {
                        "name" : "email-forward"
                     }
                  ],
                  "id" : "namecheap",
                  "name" : "Namecheap",
                  "notes" : {
                     "feeIcann" : {
                        "addedToListPrice" : true,
                        "amount" : "0.18"
                     }
                  },
                  "price" : "7.16",
                  "prices" : {
                     "register" : "6.16",
                     "renewal" : "14.16",
                     "restore" : "13.98",
                     "transfer" : "7.16",
                     "whoisPrivacy" : "0.00"
                  },
                  "pricetype" : "transfer",
                  "terms" : {
                     "limitPerCustomer" : {
                        "count" : 1
                     }
                  },
                  "threeYearValueScore" : "10.15"
               }
            ]
         },
         "currency" : "USD",
         "median" : {
            "register" : "10.95",
            "renewal" : "10.95",
            "transfer" : "9.95"
         },
         "name" : "com",
         "registrarsIncluded" : 5,
         "registrarsTotal" : 59
      }
   ],
   "errors" : [],
   "seconds" : 0.126,
   "status" : "SUCCESS"
}

Registrierkassen-Methoden

getIds

Gibt alle Registrierstellen-IDs zurück, von denen jede eine Registrierstelle eindeutig identifiziert, die aktiv auf TLD-List gelistet ist.

API-Endpunkt:https://api.tld-list.com/v1/registrar/getIds

Reaktionszeit:< 1 second

Parameter anfordern

Keine

Antwort-Objekt

Pfad Typ Beschreibung
data array of strings Array von String-Registrar-IDs.

Beispiel Anfrage/Antwort

curl -X POST https://api.tld-list.com/v1/registrar/getIds -H 'Content-Type: application/json' -d '{"apiKeyPublic":"MY_PUBLIC_KEY","apiKeyPrivate":"MY_PRIVATE_KEY"}'

{
   "data" : [
      "101domain",
      "123reg",
      "above.com",
      ...
      "upflare",
      "webnames.ca"
   ],
   "errors" : [],
   "seconds" : 0.001,
   "status" : "SUCCESS"
}