API
Fragen Sie die auf TLD-List angezeigten Daten programmatisch aus der Echtzeit-Datenbank ab.
Wir arbeiten an der Verbesserung unserer API
In Kürze wird eine robuste und intuitive JSON-API verfügbar sein. Diese API ermöglicht Unternehmenskunden die programmgesteuerte Abfrage von Daten aus der Echtzeit-Datenbank von TLD-List. Nahezu alle auf dieser Website angezeigten Daten werden über die API zugänglich sein, mit der Möglichkeit zur Filterung über benutzerdefinierte Parameter.
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ältcode: Zeichenkette zur Identifizierung des Fehlertypsmessage: von Menschen lesbare Zeichenfolge, die den Fehler beschreibtParameter: 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:'{' |
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: '{'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: '{' |
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: '{'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: '{' |
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: '{' |
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: '{' |
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: [ |
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 istdiscount - bedeutet, dass das Betragsfeld der Werbeaktion vom regulären Preis subtrahiert wurde, um den angewandten Preis zu erhaltendiscount-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.
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 | Nein | 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 | Nein | 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. Verschachtelte Felder werden nicht unterstützt. Beispiel: "includeFields": ["name", "registrars", "dnssecSupported"] |
excludeFields | array of strings | Nein | Geben Sie die auszuschließenden Daten nach Schlüsselnamen an. Schlüssel, die in diesem Parameter angegeben werden, werden ausgelassen. Standardmäßig werden keine Felder ausgeschlossen. Verschachtelte Felder werden nicht unterstützt. Beispiel: "excludeFields": ["available", "syntax", "sponsor"] |
includeRegistrars | array of strings | Nein | 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 | Nein | 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 | Nein | 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[].name | string | Unicode-Name der Domänenerweiterung. |
data[].registrars | array of objects | Array von RegistrarPricing-Objekten, die Daten zu Preisen und Funktionen des Registrars enthalten. |
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. |
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"
'}',
"dnssecSupported" : true,
"level" : 1,
"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"
'}'
],
"registerMaxYears" : 10,
"registerMinYears" : 1,
"registrars" : [
'{'
"currency" : "USD",
"id" : "godaddy",
"name" : "GoDaddy",
"prices" : '{'
"register" : "3.17",
"renewal" : "20.17",
"transfer" : "8.17"
'}',
"threeYearValueScore" : "5.76"
'}',
'{'
"currency" : "USD",
"id" : "epik",
"name" : "Epik",
"prices" : '{'
"register" : "9.99",
"renewal" : "10.99"
'}',
"threeYearValueScore" : "8.29"
'}',
'{'
"currency" : "USD",
"id" : "porkbun",
"name" : "Porkbun",
"prices" : '{'
"register" : "8.73",
"renewal" : "9.73",
"transfer" : "9.73"
'}',
"threeYearValueScore" : "16.03"
'}'
],
"type" : "gTLD"
'}'
],
"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 | Nein | Bei true werden Erweiterungen, die keine Preisdaten des Registrars in den Ergebnissen haben, ausgelassen. Die Voreinstellung ist false. |
wantPunycode | boolean | Nein | 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",
"abogado",
...more extensions...,
"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 | Nein | 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 | Nein | 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 | Nein | 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. Beispiel: "includeRegistrars": ["godaddy", "porkbun", "namecheap"] |
excludeRegistrars | array of strings | Nein | 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. Beispiel: "excludeRegistrars": ["godaddy", "porkbun", "namecheap"] |
omitExtensionsWithoutRegistrars | boolean | Nein | 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.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[].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. |
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" : "8.90",
"renewal" : "14.10",
"transfer" : "9.30"
'}',
"cheapest" : '{'
"register" : [
'{'
"currency" : "USD",
"id" : "godaddy",
"name" : "GoDaddy",
"price" : "3.17",
"pricetype" : "register"
'}'
],
"renewal" : [
'{'
"currency" : "USD",
"id" : "porkbun",
"name" : "Porkbun",
"price" : "9.73",
"pricetype" : "renewal"
'}'
],
"transfer" : [
'{'
"currency" : "USD",
"id" : "namecheap",
"name" : "Namecheap",
"price" : "7.16",
"pricetype" : "transfer"
'}'
]
'}',
"currency" : "USD",
"median" : '{'
"register" : "10.95",
"renewal" : "10.95",
"transfer" : "9.95"
'}',
"name" : "com",
"registrarsIncluded" : 5
'}'
],
"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",
...more registrars...,
"webnames.ca"
],
"errors" : [],
"seconds" : 0.001,
"status" : "SUCCESS"
'}'