API v1 Dokumentacja

Informacje o obsługiwanych metodach, parametrach, zwracanych danych i przykłady.

Ostrzeżenie: API jest obecnie w fazie rozwoju i podlega dodaniu nowych funkcji: nowe metody i parametry mogą zostać dodane w przyszłości. Wszelkie wprowadzone zmiany pozostaną wstecznie kompatybilne z istniejącą funkcjonalnością.

Przegląd

Interfejs API TLD-List v1 może być używany do pobierania danych wyświetlanych na stronie TLD-List z bazy danych na żywo.

API akceptuje HTTP POST zawierające dane JSON i odpowiada danymi JSON. Wymagania dla wszystkich żądań metod API:

  • Żądania muszą być składane przy użyciu metody HTTP POST
  • Żądania muszą mieć treść JSON zawierającą prawidłową parę publicznych i prywatnych kluczy API do uwierzytelniania
  • Żądania muszą zawierać nagłówek: Content-Type: application/json

Parametry są przekazywane do interfejsu API jako klucze/wartości w treści żądania zakodowanej w formacie JSON.

Podstawowy adres URL dla wszystkich żądań API to:

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

Uwierzytelnianie

Uwierzytelnianie odbywa się poprzez przekazanie publicznego klucza API i prywatnego klucza API w treści JSON przesłanej do adresu URL metody. Wszystkie wywołania API muszą zawierać prawidłową parę kluczy API. Pary kluczy API można wygenerować na koncie TLD-List w zakładce API.

Proszę odwiedzić Konto > API, aby utworzyć klucze API.

Klucze API są przekazywane w treści żądania JSON przy użyciu parametrów apiKeyPublic (Państwa klucz publiczny) i apiKeyPrivate (Państwa klucz prywatny).

Example authentication parameters

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

Odpowiedź

Wszystkie pomyślne odpowiedzi API będą miały kod stanu HTTP 200 SUCCESS i zakodowaną treść JSON. Każdy inny kod stanu HTTP w odpowiedzi wskazuje, że żądanie nie powiodło się i wystąpił błąd.

Obiekty odpowiedzi JSON zwracane przez API będą miały następującą strukturę:

Klucz Typ Opis
status string Określa status żądania. SUCCESS oznacza, że wywołanie API powiodło się, FAIL oznacza, że żądanie nie powiodło się.
errors array of objects Tablica obiektów reprezentujących błędy, które wystąpiły. Każdy obiekt błędu będzie zawierał

kod: ciąg znaków identyfikujący typ błędu

komunikat: czytelny dla człowieka ciąg znaków opisujący błąd

parameter: opcjonalny ciąg lub tablica ciągów wskazujących na problem z określonym parametrem (parametrami) przekazanymi w żądaniu.

Jeśli nie wystąpiły żadne błędy, tablica błędów będzie pusta.

Więcej informacji można znaleźć w sekcji Kody błędów.
seconds number Czas potrzebny serwerowi API na wygenerowanie odpowiedzi (w sekundach).
data string|array|object Obiekt, tablica lub ciąg znaków zawierający żądane dane.

Przykład nieudanego obiektu odpowiedzi z błędami

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

Przykład pomyślnego obiektu odpowiedzi

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

Wspólne obiekty odpowiedzi

Niektóre metody API zwracają obiekty danych o tej samej strukturze. Te typowe obiekty danych zostały szczegółowo opisane poniżej.

RegistrarPricing

Opisuje ceny detaliczne rejestratora dla rozszerzenia dla określonego typu cenowego (register, renewal, transfer), w tym dodatkowe szczegóły, takie jak specjalne warunki, opłaty, podatki i promocje.

Ścieżka Typ Opis
id string Ciąg identyfikatora rejestratora, który jednoznacznie identyfikuje rejestratora.
name string Wyświetlana nazwa rejestratora.
price string Ostateczna cena detaliczna rejestratora dla rozszerzenia i typu cenowego.

Uwaga: to pole jest obecne tylko wtedy, gdy obiekt RegistrarPricing jest zagnieżdżony w kontekście typu ceny (na przykład w odpowiedzi z getCheapestRegistrars).
priceOriginal string Regularna cena detaliczna rejestratora dla rozszerzenia jako ciąg liczbowy. To pole będzie obecne tylko wtedy, gdy cena jest ceną promocyjną.

Uwaga: to pole jest obecne tylko wtedy, gdy obiekt RegistrarPricing jest zagnieżdżony w kontekście typu ceny (na przykład w odpowiedzi z getCheapestRegistrars).
pricetype string Typ ceny rozszerzenia, jeden z: register, renewal, transfer.

Uwaga: to pole jest obecne tylko wtedy, gdy obiekt RegistrarPricing jest zagnieżdżony w kontekście typu ceny (na przykład w odpowiedzi z getCheapestRegistrars).
prices object Cena detaliczna rejestratora dla rozszerzenia dla wszystkich typów cen.
prices[pricetype] string Ostateczna cena detaliczna rejestratora dla rozszerzenia i [ pricetype ], gdzie klucz [pricetype] to register, renewal, transfer, restore, whoisprivacy. Przykład:

{
    "register": "8.73",
    "renewal": "9.73",
    "transfer": "9.73",
    "whoisPrivacy": "0.00"
}
pricesOriginal object Regularna cena detaliczna rejestratora dla rozszerzenia dla wszystkich typów cen. To pole nie będzie dostępne, jeśli rejestrator nie ma aktywnych promocji.
pricesOriginal[pricetype] string Regularna cena detaliczna rejestratora dla rozszerzenia i [pricetype ], gdzie klucz [pricetype] to register, renewal, transfer, restore, whoisprivacy.
promo object Obiekt RegistrarPromo reprezentujący promocyjną cenę, która została zastosowana do ceny rejestratora dla tego rozszerzenia i typu ceny. Jeśli nie zastosowano promocji, to pole nie będzie obecne. Przykładowy obiekt promocyjny: 

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


Uwaga: to pole jest obecne tylko wtedy, gdy obiekt RegistrarPricing jest zagnieżdżony w kontekście typu ceny (na przykład w odpowiedzi z getCheapestRegistrars).
promos array of objects Tablica obiektów RegistrarPromo reprezentujących wszystkie aktywne ceny promocyjne oferowane przez rejestratora dla tego rozszerzenia.
terms object Kolekcja obiektów reprezentujących specjalne warunki, które mają zastosowanie do cennika rejestratora. Jeśli żadne specjalne warunki nie mają zastosowania, to pole nie będzie obecne. Każdy obiekt podrzędny jest powiązany z identyfikatorem warunku:

limitPerCustomer - określa, że cena jest ważna tylko dla określonej liczby domen na klienta.
newCustomerOnly - określa, że cena jest ważna tylko dla nowych klientów.
affiliateLink - określa, że cena jest ważna tylko wtedy, gdy klient uzyskuje dostęp do witryny rejestratora za pośrednictwem linku partnerskiego.
nameserverLockIn - określa, że zakupione domeny mogą korzystać tylko z serwerów nazw rejestratora.
idSubmissionRequired - określa, że klient musi przesłać swój identyfikator ze zdjęciem lub rejestrację firmy, aby sfinalizować zakup.

Przykładowe obiekty warunków: 

{
    "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 Ilość, do której termin ogranicza klienta. Na przykład, jeśli count = 1, klient jest ograniczony do 1 domeny w określonej cenie. To pole nie będzie obecne, jeśli nie ma zastosowania.
terms[term].pricetype array of strings Typ(y) ceny, do których odnosi się termin: register, renewal, transfer. To pole będzie obecne tylko wtedy, gdy typ ceny obiektu RegistrarPricing nie zostanie określony.
notes object Kolekcja obiektów reprezentujących noty, które odnoszą się do wyceny rejestratora. Jeśli nie ma not cenowych, wartość ta będzie pustym obiektem. Każdy obiekt podrzędny jest powiązany z identyfikatorem noty: currencyExchangeRate, feeIcann, feeTax, feePayment
notes.feeIcann object Określa, czy opłata ICANN została dodana do ostatecznej ceny TLD (zazwyczaj 0,18 USD USD). Jeśli ta uwaga istnieje, oznacza to, że rejestrator nie uwzględnia opłaty ICANN w swojej reklamowanej cenie, a zamiast tego dodaje ją jako dodatkową opłatę do ceny TLD's przy kasie klienta.

Przykładowy obiekt notatki fee_icann: 

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

Pole pricetype określa, które typy cen podlegają opłacie, a pole addedToListPrice wskazuje, że opłata została dodana do ceny końcowej.
notes.feeTax array of objects Określa różne stawki podatkowe pobierane przez rejestratora, klientów, których dotyczy podatek, oraz czy obliczony podatek został uwzględniony w ostatecznej cenie TLD. Proszę zauważyć, że podatki są uwzględniane w ostatecznej cenie TLD tylko wtedy, gdy rejestrator nie uwzględnia podatku w swoich reklamowanych cenach , a podatek jest naliczany wszystkim klientom.

Przykładowa tablica obiektów feeTax: 

{
    "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 Etykieta opisująca rodzaj podatku, tj. "vat" dla podatku od wartości dodanej, "gst" dla podatku od towarów i usług itp.
notes.feeTax[].amountRate number|string Kwota stawki podatkowej. Będzie to albo procentowa stawka podatku jako liczba, albo ciąg "~" wskazujący, że stawka podatku różni się w zależności od kryteriów klienta, takich jak lokalizacja.
notes.feeTax[].amountRateType string Wartość łańcuchowa " percent" wskazuje, że wartość amountRate jest liczbową wartością procentową. Wartość łańcuchowa "percent-varies-by-location " wskazuje, że stawka podatku różni się w zależności od regionu rozliczeniowego lub kraju klienta.
notes.feeTax[].appliesToCustomers string|array of strings ciąg "*" oznacza, że podatek dotyczy wszystkich klientów. W przeciwnym razie wartość ta będzie tablicą ciągów kodów krajów ISO 3166-1 alpha-2 określających, które kraje podlegają podatkowi. Warto zwrócić uwagę na jeden wyjątek: tablica może zawierać ciąg znaków "eu" niebędący kodem kraju, który reprezentuje wszystkie kraje Unii Europejskiej.
notes.feeTax[].addedToListPrice boolean Wskazuje, czy obliczona kwota podatku została dodana do ceny końcowej.
notes.feePayment object Określa, czy rejestrator pobiera dodatkową opłatę w oparciu o metodę płatności klienta i czy opłata została uwzględniona w ostatecznej cenie TLD.
Przykładowy obiekt feePayment: 

{
    "feePayment": {
        "addedToListPrice": false,
        "amountRate": "~",
        "amountRateMin": "0.9",
        "amountRateMax": "20",
        "amountRateType": "percent-varies-by-method"
    }
}
notes.feePayment.amountRate string Kwota opłaty. Będzie to albo procentowa stawka opłaty jako liczba, albo ciąg "~" wskazujący, że stawka opłaty różni się w zależności od kryteriów klienta, takich jak metoda płatności.
notes.feePayment.amountRateMin string Minimalna kwota opłaty, ma zastosowanie tylko wtedy, gdy opłata jest zmienna.
notes.feePayment.amountRateMax string Maksymalna kwota opłaty, ma zastosowanie tylko wtedy, gdy opłata jest zmienna.
notes.feePayment.amountRateType string Wartość ciągu znaków " percent " wskazuje, że wartość amountRate jest liczbową wartością procentową. Wartość ciągu znaków "percent-varies-by-method " wskazuje, że opłata jest wartością procentową, która różni się w zależności od metody płatności klienta.
notes.feePayment.addedToListPrice boolean Wskazuje, czy obliczona kwota opłaty została dodana do ceny końcowej.
notes.currencyExchangeRate object Określa, że ceny rejestratora były podane w innej walucie krajowej i zostały przeliczone na USD. Szczegóły przeliczenia waluty są reprezentowane jako:

base: waluta cenowa rejestratora jako 3-literowy kod (np. EUR)
quote: waluta, na którą ceny zostały przeliczone (zawsze będzie to USD)
rate: kurs wymiany zastosowany do przeliczenia waluty.

Przykładowy obiekt noty currencyExchangeRate: 

{
    "currencyExchangeRate": {
        "base": "GBP",
        "quote": "USD",
        "rate": "1.2482"
    }
}
threeYearValueScore number Liczbowa miara wartości, określona na podstawie cen i bezpłatnych funkcji, za posiadanie domeny z tym rozszerzeniem za pośrednictwem rejestratora przez okres 3 lat. Im większa liczba, tym większa wartość.
currency string Trzyliterowy kod waluty ISO 4217 danych cenowych. Ta wartość jest obecnie tylko USD.
freeFeatures array of objects Tablica obiektów reprezentujących bezpłatne funkcje oferowane przez rejestratora wraz z własnością domeny. Obiekt zawiera ilość i czas trwania każdej funkcji. Każdy obiekt jest powiązany z identyfikatorem bezpłatnej funkcji:

dns - bezpłatna usługa DNS.
whois-privacy - usługa prywatności WHOIS.
email-account - bezpłatne konto(a) e-mail.
email-forward - bezpłatne przekazywanie wiadomości e-mail.
ssl-cert - bezpłatne podstawowe certyfikaty SSL.

Przykładowa tablica bezpłatnych funkcji: 

[
    {
        "name": "dns"
    },
    {
        "name": "whois-privacy"
    },
    {
        "name": "email-account",
        "count": 5
    },
    {
        "name": "ssl-cert",
        "duration": 365
    }
]
freeFeatures[].count number Ilość funkcji, którą rejestrator oferuje bezpłatnie. To pole nie będzie obecne, jeśli nie ma zastosowania.
freeFeatures[].duration number Liczba dni, przez które funkcja jest oferowana bezpłatnie przez rejestratora. Jeśli czas trwania = 365, funkcja jest oferowana bezpłatnie przez 1 rok. To pole nie będzie obecne, jeśli nie ma zastosowania.

RegistrarPromo

Opisuje aktywną promocję oferowaną przez rejestratora. Przykład: 

{
    "code": "MYCOUPONCODE",
    "amount": "20.00",
    "type": "discount-percent",
    "start": "2015-06-22T00:00:00",
    "end": "2025-06-22T00:00:00"
}
Ścieżka Typ Opis
promo.code string Kod promocyjny, który klient musi wprowadzić przy kasie, aby skorzystać ze zniżki.
promo.amount string Wartość liczbowa ceny promocyjnej. W zależności od typu promocji, może to być obniżona cena (cena), kwota odjęta od ceny regularnej(rabat) lub kwota procentowa odjęta od ceny regularnej(procent rabatu).
promo.type string Ciąg znaków reprezentujący typ ceny promocyjnej. Będzie to jedna z następujących wartości:

price - oznacza, że pole kwoty promocji jest nową obniżoną ceną
discount - oznacza, że pole kwoty promocji zostało odjęte od ceny regularnej w celu uzyskania zastosowanej ceny
discount-percent - oznacza, że pole kwoty promocji jest wartością procentową, a wartość procentowa została odjęta od ceny regularnej w celu uzyskania zastosowanej ceny.
promo.start string Czas ISO 8601 (strefa czasowa UTC) rozpoczęcia promocji. Nie będzie obecny, jeśli nie było określonej daty rozpoczęcia. Przykład: 2015-06-22T00:00:00
promo.end string Godzina zakończenia promocji w formacie ISO 8601 (strefa czasowa UTC). Nie będzie obecny, jeśli nie ma określonej daty zakończenia. Przykład: 2025-06-22T00:00:00
promo.pricetype array of strings Typ(y) ceny, do których odnosi się promocja: register, renewal, transfer.

Uwaga: to pole jest obecne tylko wtedy, gdy jest zagnieżdżone w kontekście typu ceny (na przykład w odpowiedzi z getCheapestRegistrars).

Kody błędów

W przypadku niepowodzenia żądania obiekt odpowiedzi JSON może zawierać jeden lub więcej obiektów błędów, które opisują, co poszło nie tak. Poniżej znajduje się niepełna lista identyfikacyjnych kodów błędów, które można ustawić w polu kodu obiektu błędu.

Kod Opis
502 Serwer API jest tymczasowo niedostępny.
RATE_LIMITED Liczba żądań API klienta przekroczyła dozwolone maksimum.
INVALID_METHOD Żądana metoda API nie istnieje.
SYSTEM Wystąpił nieznany błąd systemu.
RESPONSE_TIMEOUT Serwer API przekroczył limit czasu podczas generowania odpowiedzi.
PARAMETER_REQUIRED Wymagany parametr dla wywoływanej metody nie został dostarczony przez klienta.
ACCOUNT_INACTIVE Konto klienta nie jest już aktywne i wymagane jest odnowienie subskrypcji w celu uzyskania dostępu do API.
NO_ACCESS Poziom konta klienta nie zapewnia dostępu do API. W celu uzyskania dostępu do API wymagana jest aktualizacja konta.
AUTH_INVALID Uwierzytelnianie nie powiodło się: podane klucze API są nieaktywne lub nieprawidłowe.
CLIENT_IPS_EXCEEDED Przekroczono maksymalny unikalny adres IP klienta, który może uzyskać dostęp do interfejsu API dla podanej pary kluczy API.
REQUEST_ENDED_BY_CLIENT Żądanie zostało zakończone przez klienta przed wygenerowaniem odpowiedzi.

Ograniczenia

Korzystanie z API podlega pewnym ograniczeniom, aby zapobiec nadużyciom. Te ograniczenia użytkowania są przedstawione poniżej i mogą ulec zmianie bez powiadomienia.

Typ Opis
Klucze API na konto 3
Limit stawek 100 maksymalna liczba żądań na 15 minut
Adresy IP klientów na klucz API 5 unikalnych adresów IP klientów na klucz na 1440 minut

Metody rozszerzenia

get

Zwraca rozszerzenia i powiązane z nimi dane dotyczące cen i szczegółów. Ta metoda jest podobna do pobierania danych wyświetlanych na jednej lub kilku stronach szczegółów TLD (na przykład .com), z wyjątkiem danych "Historia najtańszych cen", które nie są zwracane przez tę metodę (proszę zobaczyć metodę getAggregateHistory dla danych historycznych).

Punkt końcowy API:https://api.tld-list.com/v1/extension/get

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

Parametry żądania

Klucz Typ Wymagane Opis
extensions array of strings

Określa, które rozszerzenia mają zostać pobrane. Proszę nie dołączać poprzedzającej kropki. Nazwy rozszerzeń mogą być unicode lub ich odpowiednikami punycode. W przypadku pominięcia zwrócone zostaną wszystkie rozszerzenia wymienione na stronie TLD-List.

Przykład: "extensions": ["com", "io", "co.uk", "移动", "xn--p1ai"]
includeFields array of strings Proszę podać określone dane do zwrócenia według nazwy klucza. Klucze niepodane w tym parametrze zostaną pominięte. Domyślnie zwracane są wszystkie dostępne pola. Listę dostępnych pól można znaleźć w tabeli odpowiedzi. Zagnieżdżone pola nie są obsługiwane.

Przykład: "includeFields": ["name", "registrars", "dnssecSupported"]
excludeFields array of strings Proszę określić dane łańcuchowe do wykluczenia według nazwy klucza. Klucze podane w tym parametrze zostaną pominięte. Domyślnie żadne pola nie są wykluczane. Listę dostępnych pól można znaleźć w tabeli odpowiedzi. Zagnieżdżone pola nie są obsługiwane.

Przykład: "excludeFields": ["available", "syntax", "sponsor"]
includeRegistrars array of strings

Ciąg identyfikatorów aktywnych rejestratorów do uwzględnienia w wynikach. Proszę użyć metody getIds, aby uzyskać listę identyfikatorów wszystkich aktywnych rejestratorów na stronie TLD-List.

Przykład: "includeRegistrars": ["godaddy", "porkbun", "namecheap"]
excludeRegistrars array of strings

Ciąg identyfikatorów aktywnych rejestratorów do wykluczenia w wynikach. Proszę użyć metody getIds, aby uzyskać listę identyfikatorów wszystkich aktywnych rejestratorów na stronie TLD-List.

Przykład: "excludeRegistrars": ["godaddy", "porkbun", "namecheap"]
omitExtensionsWithoutRegistrars boolean

Gdy wartość true, rozszerzenia, które nie mają danych cennika rejestratora w wynikach, są pomijane. Domyślnie uwzględniane są wszystkie rozszerzenia.

Przykład: "omitExtensionsWithoutRegistrars": true

Obiekt odpowiedzi

Ścieżka Typ Opis
data array of objects Tablica nazw rozszerzeń.
data[].available object Obiekt dat dostępności fazy TLD.
data[].available.general object Czas ISO 8601 (strefa czasowa UTC), kiedy rejestracja domeny jest dostępna dla ogółu społeczeństwa.
data[].available.sunrise object Obiekt początkowych i końcowych zakresów dat reprezentujących fazę TLD's Sunrise (kiedy właściciele znaków towarowych mogą rozpocząć ubieganie się o rejestrację odpowiednich domen). Przykład: 

{
    "sunrise": {
        "start": "2017-06-19T00:00:00.000Z",
        "end": "2017-08-21T00:00:00.000Z"
    }
}
data[].available.trademark object Obiekt początkowych i końcowych zakresów dat reprezentujących fazę znaku towarowego TLD's (okres, w którym właściciele znaków towarowych zostaną powiadomieni przez Trademark Clearinghouse, jeśli domena zostanie zarejestrowana zgodnie z ich znakiem). Przykład: 

{
    "trademark": {
        "start": "2019-06-18T00:00:00.000Z",
        "end": "2020-09-21T00:00:00.000Z"
    }
}
data[].available.other array of objects Tablica obiektów reprezentujących różne fazy uruchamiania TLD i ich zakresy czasowe, takie jak "Land Rush" i "Qualified Launch Program". Przykład: 

{
    "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 Obiekt zawierający średnią cenę rozszerzenia, według typu ceny, dla uwzględnionych rejestratorów. Przykład: 

{
    "average": {
        "register": "7.63",
        "renewal": "13.63",
        "transfer": "9.63"
    }
}
data[].average[pricetype] string Średnia cena rozszerzenia jako ciąg liczbowy dla [ pricetype], gdzie klucz [pricetype] to register, renewal, transfer, restore, whoisprivacy.
data[].category string Kategorie, do których TLD została zaklasyfikowana. Każdy obiekt w tablicy reprezentuje kategorię i zawiera następujące pola:

id - całkowity identyfikator kategorii używany wewnętrznie przez TLD-List.
idstr - alternatywny identyfikator kategorii.
name - nazwa kategorii w języku angielskim.
desc - opis kategorii w języku angielskim.

Przykładowa tablica kategorii: 

[
    {
        "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 Jeśli strefa DNS rejestru obsługuje rozszerzenia bezpieczeństwa DNS (DNSSEC).
data[].hasPremiumDomains object Obiekt kluczy [pricetype] i wartości logicznych, reprezentujący, czy rejestr pobiera wyższe ceny za wybrane nazwy domen "premium". Przykład: 

{
    "hasPremiumDomains": {
        "register": false,
        "renewal": false
    }
}
data[].infoUpdated string Czas ISO 8601 (strefa czasowa UTC), kiedy podstawowe informacje TLD's (ograniczenia, daty dostępności itp.) zostały ostatnio sprawdzone i zaktualizowane. Uwaga: nowa data updated. info niekoniecznie oznacza, że nastąpiła jakakolwiek zmiana danych. Wskazuje tylko, kiedy dane zostały ostatnio sprawdzone i ustawione.
data[].intendedUsage string Ogólne informacje o tym, jak rozszerzenie ma być używane przez rejestrujących.
data[].language string 2-znakowy kod języka ISO 639-1. Jeśli język jest angielski lub nieznany, to pole nie będzie obecne.
data[].level integer Liczba całkowita reprezentująca poziom domeny rozszerzenia. 1 = domena najwyższego poziomu, 2 = domena drugiego poziomu, 3 = domena trzeciego poziomu itd.
data[].localPresenceRequired boolean Jeśli rejestr wymaga, aby rejestrujący posiadał adres fizyczny w danym regionie.
data[].median object Obiekt zawierający medianę ceny rozszerzenia, według typu ceny, dla uwzględnionych rejestratorów. Przykład: 

{
    "median": {
        "register": "3.17",
        "renewal": "20.17",
        "transfer": "8.17"
    }
}
data[].median[pricetype] string Mediana ceny rozszerzenia jako ciąg liczbowy dla [ pricetype], gdzie klucz [pricetype] to register, renewal, transfer, restore, whoisprivacy.
data[].name string Nazwa Unicode rozszerzenia domeny.
data[].nameservers array Główne serwery nazw rejestru, które przechowują autorytatywne serwery nazw zarejestrowanych domen. Przykładowa tablica serwerów nazw: 

{
    "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 Nadrzędna domena najwyższego poziomu rozszerzenia. Jeśli jest to TLD, to pole nie będzie obecne.
data[].pricingUpdated string Data i godzina ISO 8601 (strefa czasowa UTC) ostatniego sprawdzenia i aktualizacji cennika rejestratora TLD's. Uwaga: nowa data updated.pricing niekoniecznie oznacza, że nastąpiła jakakolwiek zmiana danych. Wskazuje jedynie, kiedy dane zostały ostatnio sprawdzone i ustawione.
data[].punycode string Nazwa punycode rozszerzenia domeny. Występuje tylko w przypadku rozszerzeń IDN.
data[].registerMaxYears integer Maksymalny okres, na jaki domena może być zarejestrowana w momencie zakupu.
data[].registerMinYears integer Minimalne lata, na które domena może być zarejestrowana w momencie zakupu.
data[].registrarsIncluded integer Liczba rejestratorów uwzględnionych w zwróconej tablicy rejestratorów.
data[].registrarsTotal integer Łączna liczba aktywnych rejestratorów sprzedających rozszerzenie.
data[].registrars array of objects Tablica obiektów RegistrarPricing zawierająca dane dotyczące cen i funkcji rejestratora.
data[].registryUrl string Oficjalna strona rejestru zawierająca informacje na temat rejestracji TLD.
data[].renewalMinYears integer Minimalny dopuszczalny okres, w którym domena może zostać odnowiona.
data[].restrictions string Krótki opis ograniczeń i wymagań dotyczących rejestracji na stronie TLD's. Jeśli nie ma żadnych ograniczeń, to pole nie będzie obecne
data[].sponsor object Obiekt zawierający dane organizacji sponsorującej lub zarządzającej rozszerzeniem.
data[].sponsor.name string Nazwa zatwierdzonej przez ICANN organizacji sponsorującej rozszerzenie lub organizacji zarządzającej ccTLD.
data[].sponsor.address string Fizyczna lokalizacja organizacji sponsorującej lub organizacji zarządzającej ccTLD. Przykładowa tablica adresów: 

{
    "sponsor": {
        "address": [
            "Minerva House",
            "Edmund Halley Road",
            "Oxford Science Park",
            "Oxford OX4 4DQ",
            "United Kingdom"
        ]
    }
}
data[].sponsorParentCompany string Nazwa podmiotu posiadającego pakiet kontrolny w organizacji sponsorującej.
data[].romanized string TLD w transkrypcji na znaki łacińskie. Jeśli język jest angielski lub nieznany, to pole nie będzie obecne.
data[].rtl string Jeśli rozszerzenie jest odczytywane od "prawej do lewej" (tj. Arabric TLDs), wartość ta będzie wynosić __true__. Jeśli jest odczytywane od "lewej do prawej", wartość ta będzie wynosić __false__. Jeśli nieznane, wartość ta nie będzie obecna.
data[].syntax object Obiekt zawierający szczegółowe informacje na temat reguł i ograniczeń dotyczących dozwolonych nazw domen rozszerzenia.
data[].syntax.minChars integer Minimalna liczba znaków w etykiecie, która może zostać zarejestrowana.
data[].syntax.maxChars integer Maksymalna liczba znaków w etykiecie, która może zostać zarejestrowana.
data[].targetMarket string Osoby lub podmioty, którym TLD ma służyć.
data[].translation string Tłumaczenie TLD na język angielski. Jeśli TLD jest już oparta na języku angielskim lub tłumaczenie jest nieznane, ta wartość nie będzie obecna.
data[].type string Typ TLD identyfikowany przez jeden z następujących ciągów znaków:

gTLD: ogólna domena najwyższego poziomu.
ccTLD : domena najwyższego poziomu z kodem kraju.
grTLD: ogólna ograniczona domena najwyższego poziomu.
sTLD: sponsorowana domena najwyższego poziomu.
data[].wholesale object Obiekt zawierający ceny hurtowe rozszerzenia według typu ceny. Ceny hurtowe to ceny pobierane przez rejestr od rejestratora za zakup nazwy domeny. Przykład: 

{
    "wholesale": {
        "register": "8.97",
        "renewal": "8.97",
        "transfer": "8.97"
    }
}
data[].whoisPrivacySupported boolean Jeśli rozszerzenie zezwala usługom WHOIS Privacy na maskowanie nazw i danych kontaktowych rejestrujących. Jeśli nie, to pole nie będzie obecne.
data[].whoisServer boolean Nazwa hosta serwera rejestru, który przechowuje informacje kontaktowe rejestrującego domenę.

Przykładowe żądanie/odpowiedź

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

Zwraca wszystkie nazwy rozszerzeń.

Punkt końcowy API:https://api.tld-list.com/v1/extension/getNames

Czas reakcji:~1 second

Parametry żądania

Klucz Typ Wymagane Opis
omitExtensionsWithoutRegistrars boolean Gdy wartość true, rozszerzenia, które nie mają danych cennika rejestratora w wynikach, są pomijane. Wartość domyślna to false.
wantPunycode boolean Koduje wszystkie zwrócone rozszerzenia IDN jako punycode zamiast unicode. Domyślnie false.

Obiekt odpowiedzi

Ścieżka Typ Opis
data array of strings Tablica nazw rozszerzeń.

Przykładowe żądanie/odpowiedź

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

Zwraca najtańszych rejestratorów/dostawców, ich ceny, medianę cen i średnią cenę za rozszerzenie domeny. Rozszerzenia, które nie są sprzedawane przez żadnego rejestratora, nie są zwracane.

Punkt końcowy API:https://api.tld-list.com/v1/extension/getCheapestRegistrar

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

Parametry żądania

Klucz Typ Wymagane Opis
pricetypes array of strings

Określa typy cen do pobrania. W przypadku pominięcia zwracane są 3 typy cen (register, renewal, transfer).

Przykład: "pricetypes": ["register", "transfer"]
extensions array of strings

Określa, które rozszerzenia mają zostać pobrane. Proszę nie dołączać poprzedzającej kropki. Nazwy rozszerzeń mogą być unicode lub ich odpowiednikami punycode. W przypadku pominięcia zwrócone zostaną wszystkie rozszerzenia wymienione na stronie TLD-List.

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

Ciąg identyfikatorów aktywnych rejestratorów do uwzględnienia przy określaniu najtańszych cen i obliczeń zbiorczych. Rejestratorzy nieokreśleni w tym parametrze będą ignorowani. Proszę użyć metody getIds, aby uzyskać listę identyfikatorów wszystkich rejestratorów aktywnie wymienionych na stronie TLD-List.

Jeśli ten parametr zostanie pominięty, uwzględnieni zostaną wszyscy rejestratorzy aktywnie wymienieni na stronie TLD-List.

Przykład: "includeRegistrars": ["godaddy", "porkbun", "namecheap"]
excludeRegistrars array of strings

Ciąg identyfikatorów aktywnych rejestratorów do wykluczenia podczas określania najtańszych cen i obliczeń zbiorczych. Proszę użyć metody getIds, aby uzyskać listę identyfikatorów wszystkich rejestratorów aktywnie wymienionych na stronie TLD-List.

Jeśli ten parametr zostanie pominięty, żaden rejestrator nie zostanie zignorowany.

Przykład: "excludeRegistrars": ["godaddy", "porkbun", "namecheap"]
omitExtensionsWithoutRegistrars boolean

Gdy wartość true, rozszerzenia, które nie mają danych cen rejestratora w wynikach, są pomijane. Sytuacja ta ma miejsce, gdy przekazane parametry excludeRegistrars i/lub includeRegistrars spowodowały, że rozszerzenie, które normalnie ma dane cennika rejestratora, nie ma pasujących danych cennika rejestratora. Rozszerzenia te są domyślnie uwzględniane, ale z pustymi tablicami dla ich danych cenowych. Proszę ustawić wartość true, aby pominąć te rozszerzenia w wynikach.

Przykład: "omitExtensionsWithoutRegistrars": true

Obiekt odpowiedzi

Ścieżka Typ Opis
data array of objects Tablica obiektów, z których każdy reprezentuje rozszerzenie domeny.
data[].name string Nazwa Unicode rozszerzenia domeny.
data[].punycode string Nazwa punycode rozszerzenia domeny. Występuje tylko w przypadku rozszerzeń IDN.
data[].currency string Trzyliterowy kod waluty ISO 4217 danych cenowych. Ta wartość jest obecnie tylko USD.
data[].registrarsIncluded number Liczba rejestratorów uwzględnionych w zwróconych danych cenowych.
data[].average object Obiekt zawierający średnią cenę rozszerzenia, według typu ceny, dla uwzględnionych rejestratorów.
data[].average[pricetype] string Średnia cena rozszerzenia jako ciąg liczbowy dla [ pricetype], gdzie klucz [pricetype] to register, renewal, transfer.
data[].median object Obiekt zawierający medianę ceny rozszerzenia, według typu ceny, dla uwzględnionych rejestratorów.
data[].median[pricetype] string Mediana ceny rozszerzenia jako ciąg liczbowy dla [ pricetype], gdzie klucz [pricetype] to register, renewal, transfer.
data[].cheapest object Obiekt zawierający najtańszych rejestratorów dla rozszerzenia według typu ceny.
data[].cheapest[pricetype] array of objects

Tablica obiektów RegistrarPricing zawierająca najtańszych rejestratorów według [ pricetype], gdzie klucz [pricetype] to register, renewal, transfer.

Dane te są tablicą, ponieważ najtańsza cena rozszerzenia może być taka sama u wielu rejestratorów.

Przykładowe żądanie/odpowiedź

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"
}

Metody rejestratora

getIds

Zwraca wszystkie identyfikatory rejestratorów, z których każdy jednoznacznie identyfikuje rejestratora aktywnie notowanego na stronie TLD-List.

Punkt końcowy API:https://api.tld-list.com/v1/registrar/getIds

Czas reakcji:< 1 second

Parametry żądania

Brak

Obiekt odpowiedzi

Ścieżka Typ Opis
data array of strings Tablica ciągów identyfikatorów rejestratora.

Przykładowe żądanie/odpowiedź

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"
}