API v1 Dokümantasyon

Desteklenen yöntemler, parametreler, döndürülen veriler ve örnekler hakkında bilgiler.

Uyarı: API şu anda geliştirilme aşamasındadır ve ek özelliklere tabidir: gelecekte yeni yöntemler ve parametreler eklenebilir. Yapılan tüm değişiklikler mevcut işlevsellikle geriye dönük olarak uyumlu kalacaktır.

Genel Bakış

TLD-List v1 API, TLD-List adresinde görüntülenen verileri canlı veritabanından almak için kullanılabilir.

API, JSON verileri içeren HTTP POST'ları kabul eder ve JSON verileriyle yanıt verir. Tüm API yöntemi istekleri için gereksinimler:

  • İstekler HTTP POST yöntemi kullanılarak yapılmalıdır
  • İstekler, kimlik doğrulama için geçerli bir genel ve özel API anahtar çifti içeren bir JSON gövdesine sahip olmalıdır
  • İstekler şu başlığı içermelidir: Content-Type: application/json

Parametreler, JSON kodlu istek gövdesinde anahtar/değerler olarak API'ye aktarılır.

Tüm API istekleri için temel URL şöyledir:

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

Kimlik Doğrulama

Kimlik doğrulama, yöntem URL'sine gönderilen JSON gövdesinde genel bir API anahtarı ve özel bir API anahtarı geçirilerek gerçekleştirilir. Tüm API çağrıları geçerli bir API anahtar çifti içermelidir. API anahtar çiftleri TLD-List hesabınızda API sekmesi altında oluşturulabilir.

API anahtarları oluşturmak için Hesap > API'yi ziyaret edin.

API anahtarları JSON istek gövdesinde apiKeyPublic (genel anahtarınız) ve apiKeyPrivate (özel anahtarınız) parametreleri kullanılarak iletilir.

Example authentication parameters

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

Yanıt

Tüm başarılı API yanıtları 200 SUCCESS HTTP durum koduna ve JSON kodlu bir gövdeye sahip olacaktır. Yanıttaki diğer HTTP durum kodları isteğin başarısız olduğunu ve bir hata oluştuğunu gösterir.

API tarafından döndürülen JSON yanıt nesneleri aşağıdaki yapıya sahip olacaktır:

Anahtar Tip Açıklama
status string İsteğin durumunu belirtir. SUCCESS, API çağrısının başarılı olduğunu, FAIL ise isteğin başarısız olduğunu gösterir.
errors array of objects Oluşan hataları temsil eden nesneler dizisi. Her hata nesnesi şunları içerecektir:

kod: hata türünü tanımlayan dize

mesaj: hatayı açıklayan insan tarafından okunabilir dize

parametre: istekte aktarılan belirli parametre(ler) ile ilgili bir sorunu belirten isteğe bağlı dize veya dizeler dizisi.

Herhangi bir hata oluşmadıysa, hata dizisi boş olacaktır.

Daha fazla bilgi için Hata Kodları bölümüne bakın.
seconds number API sunucusunun bir yanıt oluşturmak için harcadığı süre (saniye cinsinden).
data string|array|object İstenen verileri içeren bir nesne, dizi veya dize.

Hataları içeren örnek başarısız yanıt nesnesi

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

Örnek başarılı yanıt nesnesi

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

Ortak Yanıt Nesneleri

API yöntemlerinden bazıları aynı yapıya sahip veri nesneleri döndürür. Bu ortak veri nesneleri aşağıda ayrıntılı olarak açıklanmıştır.

RegistrarPricing

Özel şartlar, ücretler, vergi ve promosyonlar gibi ek ayrıntılar da dahil olmak üzere, bir kayıt kuruluşunun belirli bir fiyat türü (register, renewal, transfer) için bir uzantıya yönelik perakende fiyatlandırmasını açıklar.

Yol Tip Açıklama
id string Kayıt kuruluşunu benzersiz bir şekilde tanımlayan kayıt kuruluşu kimliği dizesi.
name string Kayıt kuruluşunun görünen adı.
price string Kayıt kuruluşunun uzantı ve fiyat türü için nihai perakende satış fiyatı.

Not: Bu alan yalnızca RegistrarPricing nesnesi bir fiyat türü bağlamında yuvalandığında (örneğin getCheapestRegistrars yanıtında) bulunur.
priceOriginal string Sayısal bir dize olarak uzantı için kayıt kuruluşunun normal perakende satış fiyatı. Bu alan yalnızca fiyat promosyonel bir fiyatsa mevcut olacaktır.

Not: Bu alan yalnızca RegistrarPricing nesnesi bir pricetype bağlamında yuvalandığında (örneğin getCheapestRegistrars yanıtında) bulunur.
pricetype string Uzantı fiyatlandırma türü, şunlardan biri: register, renewal, transfer.

Not: Bu alan yalnızca RegistrarPricing nesnesi bir pricetype bağlamında yuvalandığında (örneğin getCheapestRegistrars yanıtında) bulunur.
prices object Kayıt kuruluşunun tüm fiyat türleri için uzantıya yönelik perakende fiyatı.
prices[pricetype] string Kayıt kuruluşunun uzantı için nihai perakende satış fiyatı ve [ pricetype], burada [pr icetype] anahtarı register, renewal, transfer, restore, whoisprivacy şeklindedir. Örnek:

{
    "register": "8.73",
    "renewal": "9.73",
    "transfer": "9.73",
    "whoisPrivacy": "0.00"
}
pricesOriginal object Kayıt kuruluşunun tüm fiyat türleri için uzantıya yönelik normal perakende fiyatı. Kayıt kuruluşunun etkin promosyonları yoksa bu alan mevcut olmayacaktır.
pricesOriginal[pricetype] string Kayıt kuruluşunun uzantı için normal perakende satış fiyatı ve [ pricetype], burada [pr icetype] anahtarı register, renewal, transfer, restore, whoisprivacy şeklindedir.
promo object Bu uzantı ve fiyat türü için kayıt kuruluşunun fiyatına uygulanan promosyon fiyatlandırmasını temsil eden bir RegistrarPromo nesnesi. Herhangi bir promosyon uygulanmamışsa bu alan mevcut olmayacaktır. Örnek promosyon nesnesi:

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


Not: Bu alan yalnızca RegistrarPricing nesnesi bir fiyat türü bağlamında yuvalandığında (örneğin getCheapestRegistrars yanıtında) bulunur.
promos array of objects Bu uzantı için kayıt kuruluşu tarafından sunulan tüm etkin promosyon fiyatlarını temsil eden RegistrarPromo nesneleri dizisi.
terms object Kayıt kuruluşunun fiyatlandırması için geçerli olan özel şartları temsil eden nesneler koleksiyonu. Hiçbir özel koşul uygulanmıyorsa, bu alan mevcut olmayacaktır. Her alt nesne bir terim kimliği ile anahtarlanır:

limitPerCustomer - fiyatlandırmanın yalnızca müşteri başına belirli sayıda alan adı için geçerli olduğunu belirtir.
newCustomerOnly - fiyatlandırmanın yalnızca yeni müşteriler için geçerli olduğunu belirtir.
affiliateLink - fiyatlandırmanın yalnızca müşteri bir bağlı kuruluş bağlantısı aracılığıyla kayıt kuruluşunun sitesine eriştiğinde geçerli olduğunu belirtir.
nameserverLockIn - satın alınan alan adlarının yalnızca kayıt kuruluşunun ad sunucularını kullanabileceğini belirtir.
idSubmissionRequired - müşterinin satın alma işlemini tamamlamak için fotoğraflı kimliğini veya işletme kaydını göndermesi gerektiğini belirtir.

Örnek terim nesneleri:

{
    "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 Terimin müşteriyi sınırladığı miktar. Örneğin, count = 1 ise, müşteri belirtilen fiyattan 1 alan adı ile sınırlandırılır. Geçerli değilse bu alan mevcut olmayacaktır.
terms[term].pricetype array of strings Terimin uygulandığı fiyat türü/türleri: register, renewal, transfer. Bu alan yalnızca RegistrarPricing nesnesinin pricetype'ı belirtilmemişse mevcut olacaktır.
notes object Kayıt kuruluşunun fiyatlandırmasıyla ilgili notları temsil eden bir nesne koleksiyonu. Fiyatlandırma notu yoksa, bu değer boş bir nesne olacaktır. Her alt nesne bir nota kimliği ile anahtarlanır: currencyExchangeRate, feeIcann, feeTax, feePayment
notes.feeIcann object TLD için nihai fiyata bir ICANN ücretinin eklenip eklenmediğini belirtir (genellikle 0,18 ABD doları USD). Bu not mevcutsa, kayıt kuruluşunun ICANN ücretini ilan edilen fiyatına dahil etmediği ve bunun yerine müşteri ödeme sırasında TLD's fiyatına ek bir ücret olarak eklediği anlamına gelir.

Örnek fee_icann not nesnesi:

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

pricetype alanı hangi fiyat türlerinin ücrete tabi olduğunu belirtir ve addedToListPrice alanı ücretin nihai fiyata eklendiğini gösterir.
notes.feeTax array of objects Bir kayıt kuruluşu tarafından alınan çeşitli vergi oranlarını, verginin uygulandığı müşterileri ve hesaplanan verginin TLD için nihai fiyata dahil edilip edilmediğini belirtir. Vergilerin TLD'nin nihai fiyatına yalnızca kayıt operatörünün ilan edilen fiyatlarına vergiyi dahil etmemesi ve verginin tüm müşterilerden tahsil edilmesi durumunda dahil edildiğini lütfen unutmayın.

Örnek feeTax nesne dizisi:

{
    "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 Vergi türünü tanımlayan etiket, örneğin Katma Değer Vergisi için 'vat', Mal ve Hizmet Vergisi için 'gst ' vb.
notes.feeTax[].amountRate number|string Vergi oranı tutarı. Bu, ya bir sayı olarak vergi yüzdesi oranı ya da vergi oranının konum gibi müşteri kriterlerine göre değiştiğini belirten '~' dizesi olacaktır.
notes.feeTax[].amountRateType string 'percent' dize değeri, amountRate değerinin sayısal bir yüzde olduğunu belirtir. 'percent-varies-by-location' dize değeri, vergi oranının müşterinin faturalandırma bölgesine veya ülkesine göre değiştiğini belirtir.
notes.feeTax[].appliesToCustomers string|array of strings '*' dizesi verginin tüm müşteriler için geçerli olduğunu gösterir. Aksi takdirde bu değer, hangi ülkelerin vergiye tabi olduğunu tanımlayan ISO 3166-1 alpha-2 ülke kodu dizelerinden oluşan bir dizi olacaktır. Dikkat edilmesi gereken bir istisna: dizi, Avrupa Birliği'ndeki tüm ülkeleri temsil eden ülke kodu olmayan 'eu' dizesini içerebilir.
notes.feeTax[].addedToListPrice boolean Hesaplanan vergi tutarının nihai fiyata eklenip eklenmediğini gösterir.
notes.feePayment object Kayıt kuruluşunun müşterinin ödeme yöntemine göre ek bir ücret alıp almadığını ve ücretin TLD için nihai fiyata dahil edilip edilmediğini belirtir.
Örnek feePayment nesnesi:

{
    "feePayment": {
        "addedToListPrice": false,
        "amountRate": "~",
        "amountRateMin": "0.9",
        "amountRateMax": "20",
        "amountRateType": "percent-varies-by-method"
    }
}
notes.feePayment.amountRate string Ücret tutarı. Bu, bir sayı olarak ücret yüzdesi oranı veya ücret oranının ödeme yöntemi gibi müşteri kriterlerine göre değiştiğini belirten '~' dizesi olacaktır.
notes.feePayment.amountRateMin string Minimum ücret tutarı, yalnızca ücret değişken ise geçerlidir.
notes.feePayment.amountRateMax string Maksimum ücret tutarı, yalnızca ücretin değişken olması durumunda geçerlidir.
notes.feePayment.amountRateType string 'percent' dize değeri, amountRate değerinin sayısal bir yüzde olduğunu belirtir. 'percent-varies-by-method' dize değeri, ücretin müşterinin ödeme yöntemine göre değişen bir yüzde olduğunu belirtir.
notes.feePayment.addedToListPrice boolean Hesaplanan ücret tutarının nihai fiyata eklenip eklenmediğini gösterir.
notes.currencyExchangeRate object Kayıt kuruluşunun fiyatlarının başka bir ulusal para biriminde listelendiğini ve USD'a dönüştürüldüğünü belirtir. Para birimi dönüşümünün ayrıntıları şu şekilde gösterilir:

base: 3 harfli bir kod olarak kayıt kuruluşunun fiyatlandırma para birimi (örn. EUR)
quote: fiyatların dönüştürüldüğü para birimi (her zaman USD olacaktır)
rate: para birimi dönüşümünü yapmak için kullanılan dövizkuru.

Örnek currencyExchangeRate not nesnesi:

{
    "currencyExchangeRate": {
        "base": "GBP",
        "quote": "USD",
        "rate": "1.2482"
    }
}
threeYearValueScore number Kayıt kuruluşu aracılığıyla 3 yıllık bir süre için bu uzantıya sahip bir alan adına sahip olmak için fiyatlandırma ve ücretsiz özelliklerle belirlenen sayısal bir değer ölçümü. Sayı ne kadar büyükse, o kadar fazla değer sunulur.
currency string Fiyatlandırma verilerinin üç harfli ISO 4217 para birimi kodu. Bu değer şu anda yalnızca USD.
freeFeatures array of objects Kayıt kuruluşunun alan adı sahipliğiyle birlikte sunduğu ücretsiz özellikleri temsil eden bir nesne dizisi. Nesne, her özelliğin miktarını ve süresini içerir. Her nesne bir ücretsiz özellik kimliği ile anahtarlanır:

dns - ücretsiz DNS hizmeti.
whois-privacy - WHOISgizlilik hizmeti.
email-account - ücretsiz e-posta hesapları.
email-forward - ücretsiz e-posta yönlendirme.
ssl-cert - ücretsiz temel SSL sertifikaları.

Örnek ücretsiz özellik dizisi:

[
    {
        "name": "dns"
    },
    {
        "name": "whois-privacy"
    },
    {
        "name": "email-account",
        "count": 5
    },
    {
        "name": "ssl-cert",
        "duration": 365
    }
]
freeFeatures[].count number Kayıt kuruluşunun ücretsiz olarak sunduğu özelliğin miktarı. Geçerli değilse bu alan mevcut olmayacaktır.
freeFeatures[].duration number Özelliğin kayıt kuruluşu tarafından ücretsiz olarak sunulduğu gün sayısı. Süre = 365 ise, özellik 1 yıl boyunca ücretsiz olarak sunulur. Geçerli değilse bu alan mevcut olmayacaktır.

RegistrarPromo

Bir kayıt kuruluşu tarafından sunulan aktif bir promosyonu tanımlar. Örnek:

{
    "code": "MYCOUPONCODE",
    "amount": "20.00",
    "type": "discount-percent",
    "start": "2015-06-22T00:00:00",
    "end": "2025-06-22T00:00:00"
}
Yol Tip Açıklama
promo.code string Müşterinin indirimli promosyonu almak için ödeme sırasında girmesi gereken promosyon kodu.
promo.amount string Promosyon fiyatlandırmasının sayısal tutarı. Promosyonun türüne bağlı olarak bu, indirimli fiyat(fiyat), normal fiyattan çıkarılan tutar (indirim) veya normal fiyattan çıkarılanyüzde tutarı (indirim yüzdesi) olabilir.
promo.type string Promosyonel fiyatlandırma türünü temsil eden bir dize. Aşağıdaki değerlerden biri olacaktır:

price - promosyonun tutar alanının yeni indirimli fiyat olduğu anlamına gelir
discount - uygulanan fiyatı elde etmek için promosyonun tutar alanının normal fiyattan çıkarıldığı anlamına gelir
discount-percent - promosyonun tutar alanının bir yüzde olduğu ve uygulanan fiyatı elde etmek için yüzdenin normal fiyattan çıkarıldığı anlamına gelir.
promo.start string Promosyonun başladığı ISO 8601 tarih saati (UTC zaman dilimi). Belirli bir başlangıç tarihi yoksa mevcut olmayacaktır. Örnek: 2015-06-22T00:00:00
promo.end string Promosyonun ne zaman sona ereceğine dair ISO 8601 tarih saati (UTC zaman dilimi). Belirli bir bitiş tarihi yoksa mevcut olmayacaktır. Örnek: 2025-06-22T00:00:00
promo.pricetype array of strings Promosyonun geçerli olduğu fiyat türü/türleri: register, renewal, transfer.

Not: Bu alan yalnızca bir fiyat türü bağlamında (örneğin getCheapestRegistrars yanıtında) yuvalandığında mevcuttur.

Hata Kodları

İstek başarısız olduğunda, JSON yanıt nesnesi neyin yanlış gittiğini açıklayan bir veya daha fazla hata nesnesi içerebilir. Aşağıda, hata nesnesinin kod alanında ayarlanabilecek tanımlayıcı hata kodlarının kapsamlı olmayan bir listesi bulunmaktadır.

Kod Açıklama
502 API sunucusu geçici olarak kullanılamıyor.
RATE_LIMITED İstemci API isteklerinin sayısı izin verilen maksimum değeri aştı.
INVALID_METHOD İstenen API yöntemi mevcut değil.
SYSTEM Bilinmeyen bir sistem hatası oluştu.
RESPONSE_TIMEOUT API sunucusu yanıt oluştururken zaman aşımına uğradı.
PARAMETER_REQUIRED Çağrılan yöntem için gerekli bir parametre istemci tarafından sağlanmadı.
ACCOUNT_INACTIVE Müşterinin hesabı artık aktif değil ve API erişimi için abonelik yenilemesi gerekiyor.
NO_ACCESS Müşterinin hesap düzeyi API erişimi sağlamaz. API erişimi için bir hesap yükseltmesi gereklidir.
AUTH_INVALID Kimlik doğrulama başarısız oldu: sağlanan API anahtarları etkin değil veya geçersiz.
CLIENT_IPS_EXCEEDED Sağlanan API anahtar çifti için API'ye erişmesine izin verilen maksimum benzersiz istemci IP'si aşıldı.
REQUEST_ENDED_BY_CLIENT İstek, bir yanıt oluşturulamadan istemci tarafından sonlandırıldı.

Sınırlar

API'nin kullanımı, kötüye kullanımı önlemek için belirli sınırlamalara tabidir. Bu kullanım sınırlamaları aşağıda gösterilmiştir ve önceden haber verilmeksizin değiştirilebilir.

Tip Açıklama
Hesap Başına API Anahtarları 3
Oran Sınırı 100 15 dakika başına maksimum talep
API Anahtarı Başına İstemci IP Adresleri 5 1440 dakika başına anahtar başına benzersiz istemci IP adresleri

Uzatma Yöntemleri

get

Uzantıları ve bunlarla ilişkili fiyatlandırma ve ayrıntı verilerini döndürür. Bu yöntem, bu yöntem tarafından döndürülmeyen "En Ucuz Fiyat Geçmişi" verileri haricinde (geçmiş veriler için getAggregateHistory yöntemine bakın), bir veya daha fazla TLD ayrıntı sayfasında (örneğin, .com) görüntülenen verileri almaya benzer.

API uç noktası:https://api.tld-list.com/v1/extension/get

Yanıt süresi:~12 seconds for all extensions, ~6 seconds < 2000 extensions, ~2 seconds < 100 extensions

İstek parametreleri

Anahtar Tip Gerekli Açıklama
extensions array of strings

Hangi uzantıların alınacağını belirtir. Öncesinde bir nokta eklemeyin. Uzantı adları unicode veya punycode eşdeğeri olabilir. Atlanırsa, TLD-List adresinde listelenen tüm uzantılar döndürülür.

Örnek: "extensions": ["com", "io", "co.uk", "移动", "xn--p1ai"]

includeFields array of strings Anahtar adına göre döndürülecek belirli verileri belirtin. Bu parametrede gönderilmeyen anahtarlar atlanacaktır. Varsayılan olarak, mevcut tüm alanlar döndürülür. Kullanılabilir alanların listesi için yanıt tablosuna bakın. Yuvalanmış alanlar desteklenmez.

Örnek: "includeFields": ["name", "registrars", "dnssecSupported"]

excludeFields array of strings Anahtar adına göre hariç tutulacak cetain verilerini belirtin. Bu parametrede gönderilen anahtarlar atlanacaktır. Varsayılan olarak, hiçbir alan hariç tutulmaz. Kullanılabilir alanların listesi için yanıt tablosuna bakın. Yuvalanmış alanlar desteklenmez.

Örnek: "excludeFields": ["available", "syntax", "sponsor"]

includeRegistrars array of strings

Sonuçlara dahil edilecek aktif kayıt operatörlerinin dize kimlikleri. TLD-List adresinde aktif olarak listelenen tüm kayıt operatörlerinin kimliklerinin bir listesini elde etmek için getIds yöntemini kullanın.

Örnek: "includeRegistrars": ["godaddy", "porkbun", "namecheap"]

excludeRegistrars array of strings

Sonuçlarda hariç tutulacak aktif kayıt operatörlerinin dize kimlikleri. TLD-List adresinde aktif olarak listelenen tüm kayıt operatörlerinin kimliklerinin bir listesini elde etmek için getIds yöntemini kullanın.

Örnek: "excludeRegistrars": ["godaddy", "porkbun", "namecheap"]

omitExtensionsWithoutRegistrars boolean

true olduğunda, sonuçlarda kayıt kuruluşu fiyatlandırma verisi bulunmayan uzantılar atlanır. Varsayılan olarak, tüm uzantılar dahil edilir.

Örnek: "omitExtensionsWithoutRegistrars": true

Yanıt nesnesi

Yol Tip Açıklama
data array of objects Uzantı adları dizisi.
data[].available object TLD aşaması kullanılabilirlik tarihlerinin nesnesi.
data[].available.general object Alan adı kaydının genel kullanıma açık olduğu ISO 8601 tarih saati (UTC zaman dilimi).
data[].available.sunrise object TLD's Sunrise aşamasını (ticari marka sahiplerinin ilgili alan adlarının tescili için başvurmaya başlayabilecekleri zaman) temsil eden başlangıç ve bitiş tarih aralıkları nesnesi. Örnek:

{
    "sunrise": {
        "start": "2017-06-19T00:00:00.000Z",
        "end": "2017-08-21T00:00:00.000Z"
    }
}
data[].available.trademark object TLD's Ticari Marka aşamasını temsil eden başlangıç ve bitiş tarih aralıkları nesnesi (ticari marka sahiplerinin, markalarıyla eşleşen bir alan adı kaydedilirse Ticari Marka Takas Merkezi tarafından bilgilendirileceği dönem). Örnek:

{
    "trademark": {
        "start": "2019-06-18T00:00:00.000Z",
        "end": "2020-09-21T00:00:00.000Z"
    }
}
data[].available.other array of objects TLD'nin çeşitli lansman aşamalarını ve bunların "Land Rush" ve "Qualified Launch Program" gibi tarih-saat aralıklarını temsil eden nesneler dizisi. Örnek:

{
    "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 Dahil edilen kayıt operatörleri için fiyat türüne göre uzantının ortalama fiyatını içeren nesne. Örnek:

{
    "average": {
        "register": "7.63",
        "renewal": "13.63",
        "transfer": "9.63"
    }
}
data[].average[pricetype] string pricetype] anahtarının register, renewal, transfer, restore, whoisprivacy olduğu [pricetype] için sayısal bir dize olarak uzantının ortalama fiyatı.
data[].category string TLD'nin sınıflandırıldığı kategoriler. Dizideki her nesne bir kategoriyi temsil eder ve aşağıdaki alanları içerir:

id - TLD-List tarafından dahili olarak kullanılan tamsayı kategori kimliği.
idstr - alternatif dize kategori kimliği.
name - İngilizce kategori adı.
desc - İngilizce kategori açıklaması.

Örnek kategori dizisi:

[
    {
        "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 Kayıt defterinin DNS bölgesi DNS Güvenlik Uzantılarını (DNSSEC) destekliyorsa.
data[].hasPremiumDomains object pricetype] anahtarları ve boolean değerlerinden oluşan nesne, kayıt defterinin belirli "premium" alan adları için daha yüksek fiyatlar talep edip etmediğini gösterir. Örnek:

{
    "hasPremiumDomains": {
        "register": false,
        "renewal": false
    }
}
data[].infoUpdated string TLD's temel bilgilerinin (kısıtlamalar, kullanılabilirlik tarihleri, vb.) en son kontrol edildiği ve güncellendiği ISO 8601 tarih saati (UTC zaman dilimi). Not: Yeni bir updated.info tarihi, herhangi bir veri değişikliğinin gerçekleştiğini göstermez. Yalnızca verilerin en son ne zaman kontrol edildiğini ve ayarlandığını gösterir.
data[].intendedUsage string Uzantının tescil ettirenler tarafından nasıl kullanılmasının beklendiği hakkında genel bilgi.
data[].language string ISO 639-1 2 karakterli dil kodu. Dil İngilizce ise veya bilinmiyorsa, bu alan mevcut olmayacaktır.
data[].level integer Uzantının etki alanı düzeyini temsil eden tamsayı. 1 = üst düzey alan adı, 2 = ikinci düzey alan adı, 3 = üçüncü düzey alan adı, vb.
data[].localPresenceRequired boolean Tescil ettirenin bölgede yerel bir fiziksel adrese sahip olması gerekiyorsa.
data[].median object Dahil edilen kayıt operatörleri için fiyat türüne göre uzantının medyan fiyatını içeren nesne. Örnek:

{
    "median": {
        "register": "3.17",
        "renewal": "20.17",
        "transfer": "8.17"
    }
}
data[].median[pricetype] string pricetype] anahtarının register, renewal, transfer, restore, whoisprivacy olduğu [pricetype] için sayısal bir dize olarak uzantının medyan fiyatı.
data[].name string Etki alanı uzantısının Unicode adı.
data[].nameservers array Kayıtlı alan adlarının yetkili ad sunucularını depolayan kayıt defterinin kök ad sunucuları. Örnek ad sunucuları dizisi:

{
    "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 Uzantının üst düzey alan adı. Bu bir TLD ise, bu alan mevcut olmayacaktır.
data[].pricingUpdated string TLD's kayıt kuruluşu fiyatlandırmasının en son kontrol edildiği ve güncellendiği ISO 8601 tarih saati (UTC zaman dilimi). Not: Yeni bir updated.pricing tarihi, herhangi bir veri değişikliğinin gerçekleştiğini göstermez. Yalnızca verilerin en son ne zaman kontrol edildiğini ve ayarlandığını gösterir.
data[].punycode string Alan adı uzantısının Punycode adı. Yalnızca IDN uzantıları için mevcuttur.
data[].registerMaxYears integer Satın alma sırasında bir alan adının kaydedilebileceği maksimum yıllar.
data[].registerMinYears integer Satın alma sırasında bir alan adının kaydedilebileceği minimum yıllar.
data[].registrarsIncluded integer Döndürülen kayıt operatörleri dizisine dahil edilen kayıt operatörlerinin sayısı.
data[].registrarsTotal integer Uzantıyı satan toplam aktif kayıt şirketi.
data[].registrars array of objects Kayıt kuruluşu fiyatlandırma ve özellik verilerini içeren RegistrarPricing nesne(ler)i dizisi.
data[].registryUrl string TLD kayıt bilgileri için kayıt kuruluşunun resmi web sitesi.
data[].renewalMinYears integer Bir alan adının yenilenebileceği izin verilen minimum yıllar.
data[].restrictions string TLD's kayıt kısıtlamaları ve gerekliliklerinin kısa bir açıklaması. Herhangi bir kısıtlama yoksa, bu alan mevcut olmayacaktır
data[].sponsor object Uzantının sponsor kuruluşu veya yönetim kuruluşu hakkında veri içeren nesne.
data[].sponsor.name string Uzantının ICANN onaylı sponsor kuruluşunun veya ccTLD yönetim kuruluşunun adı.
data[].sponsor.address string Sponsor kuruluşun veya ccTLD yönetim kuruluşunun fiziksel konumu. Örnek adres dizisi:

{
    "sponsor": {
        "address": [
            "Minerva House",
            "Edmund Halley Road",
            "Oxford Science Park",
            "Oxford OX4 4DQ",
            "United Kingdom"
        ]
    }
}
data[].sponsorParentCompany string Sponsor kuruluşta kontrol hissesine sahip olan kuruluşun adı.
data[].romanized string TLD latin karakterlere dönüştürülmüştür. Dil İngilizce tabanlı ise veya bilinmiyorsa, bu alan mevcut olmayacaktır.
data[].rtl string Uzantı "sağdan sola" okunuyorsa (örn. Arabric TLDs), bu değer şu şekilde olacaktır __true__. Eğer "soldan sağa" doğru okunursa, bu değer __false__. Bilinmiyorsa, bu değer mevcut olmayacaktır.
data[].syntax object Uzantının izin verilen alan adı kuralları ve kısıtlamaları hakkında ayrıntılar içeren nesne.
data[].syntax.minChars integer Etikette kaydedilmesine izin verilen minimum karakter sayısı.
data[].syntax.maxChars integer Etikette kaydedilmesine izin verilen maksimum karakter sayısı.
data[].targetMarket string TLD'nin hizmet etmesi amaçlanan kişi veya kuruluşlar.
data[].translation string TLD'nin İngilizce çevirisi. TLD zaten İngilizce tabanlı ise veya çeviri bilinmiyorsa, bu değer mevcut olmayacaktır.
data[].type string Aşağıdaki dizelerden biriyle tanımlanan TLD türü:

gTLD: genel üst düzey alan adı.
ccTLD : ülke kodu üst düzey alan adı.
grTLD: genel-kısıtlı üst düzey alan adı.
sTLD: sponsorlu üst düzey alan adı.
data[].wholesale object Fiyat türüne göre uzantının toptan fiyatlarını içeren nesne. Toptan fiyatlar, alan adı satın alımları için kayıt kuruluşu tarafından tahsil edilen fiyatlardır. Örnek:

{
    "wholesale": {
        "register": "8.97",
        "renewal": "8.97",
        "transfer": "8.97"
    }
}
data[].whoisPrivacySupported boolean Uzantı, WHOIS Gizlilik hizmetlerinin kayıt ettirenlerin adlarını ve iletişim bilgilerini maskelemesine izin veriyorsa. Bilinmiyorsa, bu alan mevcut olmayacaktır.
data[].whoisServer boolean Alan adı kayıt sahibinin iletişim bilgilerini depolayan kayıt sunucusunun ana bilgisayar adı.

Örnek istek/cevap

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

Tüm uzantı adlarını döndürür.

API uç noktası:https://api.tld-list.com/v1/extension/getNames

Yanıt süresi:~1 second

İstek parametreleri

Anahtar Tip Gerekli Açıklama
omitExtensionsWithoutRegistrars boolean true olduğunda, sonuçlarda kayıt kuruluşu fiyatlandırma verisi bulunmayan uzantılar atlanır. Varsayılan değer yanlıştır.
wantPunycode boolean Döndürülen tüm IDN uzantılarını unicode yerine punycode olarak kodlayın. Varsayılan değer false.

Yanıt nesnesi

Yol Tip Açıklama
data array of strings Uzantı adları dizisi.

Örnek istek/cevap

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

En ucuz alan adı kayıt şirketlerini/sağlayıcılarını, fiyatlarını, ortanca fiyatı ve alan adı uzantısı başına ortalama fiyatı döndürür. Herhangi bir kayıt şirketi tarafından satılmayan uzantılar döndürülmez.

API uç noktası:https://api.tld-list.com/v1/extension/getCheapestRegistrar

Yanıt süresi:~8 seconds for all extensions, ~4 seconds < 2000 extensions, ~1 second < 100 extensions

İstek parametreleri

Anahtar Tip Gerekli Açıklama
pricetypes array of strings

Alınacak fiyatlandırma türlerini belirtir. Atlanırsa, 3 fiyat türü (register, renewal, transfer) döndürülür.

Örnek: "pricetypes": ["register", "transfer"]

extensions array of strings

Hangi uzantıların alınacağını belirtir. Öncesinde bir nokta eklemeyin. Uzantı adları unicode veya punycode eşdeğeri olabilir. Atlanırsa, TLD-List adresinde listelenen tüm uzantılar döndürülür.

Örnek: "extensions": ["com", "io", "co.uk", "移动", "xn--p1ai"]

includeRegistrars array of strings

En ucuz fiyatlandırma ve toplu hesaplamalar belirlenirken dahil edilecek aktif kayıt operatörlerinin dize kimlikleri. Bu parametrede belirtilmeyen kayıt operatörleri yok sayılır. TLD-List adresinde aktif olarak listelenen tüm kayıt operatörlerinin kimliklerinin bir listesini elde etmek için getIds yöntemini kullanın.

Bu parametre atlanırsa, TLD-List adresinde aktif olarak listelenen tüm kayıt operatörleri dikkate alınacaktır.

Örnek: "includeRegistrars": ["godaddy", "porkbun", "namecheap"]

excludeRegistrars array of strings

En ucuz fiyatlandırma ve toplu hesaplamalar belirlenirken hariç tutulacak aktif kayıt operatörlerinin dize kimlikleri. TLD-List adresinde aktif olarak listelenen tüm kayıt operatörlerinin kimliklerinin bir listesini elde etmek için getIds yöntemini kullanın.

Bu parametre atlanırsa, hiçbir kayıt operatörü göz ardı edilmeyecektir.

Örnek: "excludeRegistrars": ["godaddy", "porkbun", "namecheap"]

omitExtensionsWithoutRegistrars boolean

true olduğunda, sonuçlarda hiçbir kayıt kuruluşu fiyatlandırma verisi olmayan uzantılar atlanır. Bu durum, geçirilen excludeRegistrars ve/veya includeRegistrars parametreleri normalde kayıt kuruluşu fiyatlandırma verilerine sahip olan bir uzantının eşleşen kayıt kuruluşu fiyatlandırma verilerine sahip olmamasına neden olduğunda ortaya çıkar. Bu uzantılar varsayılan olarak dahil edilir, ancak fiyatlandırma verileri için boş diziler bulunur. Bu uzantıları sonuçlardan çıkarmak için true olarak ayarlayın.

Örnek: "omitExtensionsWithoutRegistrars": true

Yanıt nesnesi

Yol Tip Açıklama
data array of objects Her biri bir etki alanı uzantısını temsil eden nesneler dizisi.
data[].name string Etki alanı uzantısının Unicode adı.
data[].punycode string Alan adı uzantısının Punycode adı. Yalnızca IDN uzantıları için mevcuttur.
data[].currency string Fiyatlandırma verilerinin üç harfli ISO 4217 para birimi kodu. Bu değer şu anda yalnızca USD.
data[].registrarsIncluded number İade edilen fiyatlandırma verilerine dahil olan kayıt şirketlerinin sayısı.
data[].average object Dahil edilen kayıt şirketleri için fiyat türüne göre uzantının ortalama fiyatını içeren nesne.
data[].average[pricetype] string pricetype] anahtarının register, renewal, transfer olduğu [pricetype] için sayısal bir dize olarak uzantının ortalama fiyatı.
data[].median object Dahil edilen kayıt şirketleri için fiyat türüne göre uzantının medyan fiyatını içeren nesne.
data[].median[pricetype] string pricetype] anahtarının register, renewal, transfer olduğu [pricetype] için sayısal bir dize olarak uzantının medyan fiyatı.
data[].cheapest object Fiyat türüne göre uzantı için en ucuz kayıt şirketlerini içeren nesne.
data[].cheapest[pricetype] array of objects

Fiyat türü] anahtarının register, renewal, transfer olduğu [fiyat türü] 'ne göre en ucuz kayıt şirketi(leri) içeren RegistrarPricing nesne(leri) dizisi.

Bu veri bir dizidir çünkü uzantı için en ucuz fiyat birden fazla kayıt kuruluşunda aynı olabilir.

Örnek istek/cevap

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

Kayıt Yöntemleri

getIds

Her biri TLD-List adresinde aktif olarak listelenen bir kayıt kuruluşunu benzersiz bir şekilde tanımlayan tüm kayıt kuruluşu kimliklerini döndürür.

API uç noktası:https://api.tld-list.com/v1/registrar/getIds

Yanıt süresi:< 1 second

İstek parametreleri

Hiçbiri

Yanıt nesnesi

Yol Tip Açıklama
data array of strings Dize kayıt kuruluşu kimlikleri dizisi.

Örnek istek/cevap

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