API v1 Dokumentasi

Informasi mengenai metode yang didukung, parameter, data yang dikembalikan, dan contoh.

Peringatan: API saat ini sedang dalam pengembangan dan tunduk pada penambahan fitur: metode dan parameter baru dapat ditambahkan di masa mendatang. Setiap perubahan yang dibuat akan tetap kompatibel dengan fungsionalitas yang ada.

Ikhtisar

API TLD-List v1 dapat digunakan untuk mengambil data yang ditampilkan di TLD-List dari basis data langsung.

API menerima HTTP POST yang berisi data JSON dan merespons dengan data JSON. Persyaratan untuk semua permintaan metode API:

  • Permintaan harus dilakukan dengan menggunakan metode HTTP POST
  • Permintaan harus memiliki badan JSON yang berisi pasangan kunci API publik dan privat yang valid untuk autentikasi
  • Permintaan harus menyertakan header: Tipe-Konten: aplikasi/json

Parameter diteruskan ke API sebagai kunci/nilai dalam badan permintaan yang dikodekan JSON.

URL dasar untuk semua permintaan API adalah:

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

Otentikasi

Otentikasi dilakukan dengan memberikan kunci API publik dan kunci API privat dalam badan JSON yang diposting ke URL metode. Semua panggilan API harus menyertakan pasangan kunci API yang valid. Kunci API dapat dibuat di akun TLD-List di bawah tab API.

Kunjungi Akun > API untuk membuat kunci API.

Kunci API dilewatkan dalam badan permintaan JSON menggunakan parameter apiKeyPublic (kunci publik Anda) dan apiKeyPrivate (kunci privat Anda).

Example authentication parameters

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

Tanggapan

Semua respons API yang berhasil akan memiliki kode status HTTP 200 SUCCESS dan badan yang dikodekan JSON. Kode status HTTP lainnya dalam respons menunjukkan bahwa permintaan gagal dan terjadi kesalahan.

Objek respons JSON yang dikembalikan oleh API akan memiliki struktur sebagai berikut:

Kunci Jenis Deskripsi
status string Menentukan status permintaan. SUKSES mengindikasikan panggilan API berhasil, GAGAL mengindikasikan permintaan gagal.
errors array of objects Array objek yang mewakili kesalahan yang terjadi. Setiap objek kesalahan akan berisi:

kode: string yang mengidentifikasi jenis kesalahan

pesan: string yang dapat dibaca manusia yang menjelaskan kesalahan

parameter: string atau larik string opsional yang menunjukkan masalah dengan parameter tertentu yang dikirimkan dalam permintaan.

Jika tidak ada kesalahan yang terjadi, larik kesalahan akan kosong.

Lihat Kode Kesalahan untuk informasi lebih lanjut.
seconds number Jumlah waktu yang dibutuhkan server API untuk menghasilkan respons (dalam detik).
data string|array|object Objek, larik, atau string yang berisi data yang diminta.

Contoh objek respons yang gagal dengan kesalahan

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

Contoh objek respons yang berhasil

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

Objek Respons Umum

Beberapa metode API mengembalikan objek data yang memiliki struktur yang sama. Objek data yang umum ini dijelaskan secara rinci di bawah ini.

RegistrarPricing

Menjelaskan harga eceran pencatat untuk perpanjangan untuk tipe harga tertentu (register, renewal, transfer), termasuk detail tambahan seperti persyaratan khusus, biaya, pajak, dan promosi.

Path Jenis Deskripsi
id string String ID Pendaftar yang mengidentifikasi pendaftar secara unik.
name string Menampilkan nama pendaftar.
price string Harga eceran akhir pendaftar untuk ekstensi dan tipe harga.

Catatan: bidang ini hanya ada jika objek RegistrarPricing bersarang di dalam konteks tipe harga (misalnya, dalam respons dari getCheapestRegistrars).
priceOriginal string Harga eceran reguler pencatat untuk ekstensi sebagai string numerik. Bidang ini hanya akan muncul jika harga adalah harga promosi.

Catatan: bidang ini hanya ada jika objek RegistrarPricing bersarang dalam konteks tipe harga (misalnya, dalam respons dari getCheapestRegistrars).
pricetype string Jenis harga ekstensi, salah satu dari: register, renewal, transfer.

Catatan: bidang ini hanya ada jika objek RegistrarPricing bersarang di dalam konteks jenis harga (misalnya, dalam respons dari getCheapestRegistrars).
prices object Harga eceran pendaftar untuk perpanjangan untuk semua tipe harga.
prices[pricetype] string Harga eceran akhir pendaftar untuk ekstensi dan [pricetype], di mana kunci [pricetype] adalah register, renewal, transfer, restore, whoisprivacy. Contoh:

{
    "register": "8.73",
    "renewal": "9.73",
    "transfer": "9.73",
    "whoisPrivacy": "0.00"
}
pricesOriginal object Harga eceran reguler registrar untuk perpanjangan untuk semua jenis harga. Kolom ini tidak akan muncul jika pendaftar tidak memiliki promo aktif.
pricesOriginal[pricetype] string Harga eceran reguler pendaftar untuk ekstensi dan [pricetype], di mana kunci [pricetype] adalah register, renewal, transfer, restore, whoisprivacy.
promo object Objek RegistrarPromo yang mewakili harga promosi yang telah diterapkan pada harga registrar untuk ekstensi dan tipe harga ini. Jika tidak ada promo yang diterapkan, bidang ini tidak akan ada. Contoh objek promo: 

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


Catatan: bidang ini hanya ada jika objek RegistrarPricing bersarang di dalam konteks tipe harga (misalnya, dalam respons dari getCheapestRegistrars).
promos array of objects Array objek RegistrarPromo yang mewakili semua harga promosi aktif yang ditawarkan oleh pendaftar untuk ekstensi ini.
terms object Kumpulan objek yang mewakili ketentuan khusus yang berlaku untuk harga pencatat. Jika tidak ada ketentuan khusus yang berlaku, bidang ini tidak akan ada. Setiap sub objek dikunci dengan ID istilah:

limitPerCustomer - menentukan bahwa harga hanya berlaku untuk sejumlah domain per pelanggan.
newCustomerOnly - menentukan bahwa harga hanya berlaku untuk pelanggan baru.
affiliateLink - menentukan bahwa harga hanya berlaku saat pelanggan mengakses situs registrar melalui tautan afiliasi.
nameserverLockIn - menentukan bahwa domain yang dibeli hanya dapat menggunakan server nama registrar.
idSubmissionRequired - menentukan bahwa pelanggan harus mengirimkan ID foto atau pendaftaran bisnis mereka untuk menyelesaikan pembelian.

Contoh istilah objek: 

{
    "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 Kuantitas yang dibatasi oleh istilah tersebut untuk pelanggan. Misalnya, jika count = 1, maka pelanggan dibatasi untuk 1 domain dengan harga yang ditentukan. Kolom ini tidak akan ada jika tidak berlaku.
terms[term].pricetype array of strings Jenis harga yang berlaku untuk istilah tersebut: register, renewal, transfer. Bidang ini hanya akan muncul jika tipe harga objek RegistrarPricing tidak ditentukan.
notes object Kumpulan objek yang mewakili catatan yang berkaitan dengan harga pendaftar. Jika tidak ada catatan harga, nilai ini akan menjadi objek kosong. Setiap sub objek dikunci dengan ID catatan: currencyExchangeRate, feeIcann, feeTax, feePayment
notes.feeIcann object Menentukan apakah biaya ICANN telah ditambahkan ke harga akhir TLD (biasanya $0,18 USD). Jika catatan ini ada, berarti pendaftar tidak menyertakan biaya ICANN dalam harga yang diiklankan, dan malah menambahkannya sebagai biaya tambahan ke harga TLD's pada saat pembayaran pelanggan.

Contoh objek catatan fee_icann: 

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

Bidang pricetype menentukan jenis harga mana yang dikenai biaya, dan bidang addedToListPrice menunjukkan bahwa biaya telah ditambahkan ke harga akhir.
notes.feeTax array of objects Menentukan berbagai tarif pajak yang dibebankan oleh pencatat, pelanggan yang dikenai pajak, dan apakah pajak yang dihitung telah dimasukkan dalam harga akhir TLD. Harap diperhatikan bahwa pajak hanya disertakan dalam harga akhir TLD jika pencatat tidak menyertakan pajak dalam harga yang diiklankan dan pajak dibebankan kepada semua pelanggan.

Contoh array objek biayaPajak: 

{
    "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 Label yang menggambarkan jenis pajak, misalnya 'PPN' untuk Pajak Pertambahan Nilai, ' PPnBM' untuk Pajak Barang dan Jasa, dll.
notes.feeTax[].amountRate number|string Jumlah tarif pajak. Ini bisa berupa tingkat persentase pajak dalam bentuk angka, atau string '~' yang menunjukkan bahwa tarif pajak bervariasi berdasarkan kriteria pelanggan, seperti lokasi.
notes.feeTax[].amountRateType string Nilai string 'persen' menunjukkan nilai amountRate adalah persentase numerik. Nilai string 'percent-varies-by-location' menunjukkan tarif pajak bervariasi berdasarkan wilayah penagihan pelanggan atau negara.
notes.feeTax[].appliesToCustomers string|array of strings string '*' menunjukkan bahwa pajak berlaku untuk semua pelanggan. Jika tidak, nilai ini akan berupa larik kode negara ISO 3166-1 alfa-2 yang menentukan negara mana yang dikenakan pajak. Satu pengecualian yang perlu diperhatikan: larik tersebut mungkin berisi string kode non-negara 'eu', yang mewakili semua negara di Uni Eropa.
notes.feeTax[].addedToListPrice boolean Menunjukkan apakah jumlah pajak yang dihitung telah ditambahkan ke harga akhir.
notes.feePayment object Menentukan apakah pencatat membebankan biaya tambahan berdasarkan metode pembayaran pelanggan, dan apakah biaya tersebut sudah termasuk dalam harga akhir TLD.
Contoh objek biayaPembayaran: 

{
    "feePayment": {
        "addedToListPrice": false,
        "amountRate": "~",
        "amountRateMin": "0.9",
        "amountRateMax": "20",
        "amountRateType": "percent-varies-by-method"
    }
}
notes.feePayment.amountRate string Jumlah biaya. Ini bisa berupa tingkat persentase biaya dalam bentuk angka, atau string '~' yang menunjukkan bahwa tingkat biaya bervariasi berdasarkan kriteria pelanggan, seperti metode pembayaran.
notes.feePayment.amountRateMin string Jumlah biaya minimum, hanya berlaku jika biaya bersifat variabel.
notes.feePayment.amountRateMax string Jumlah biaya maksimum, hanya berlaku jika biaya bersifat variabel.
notes.feePayment.amountRateType string Nilai string 'persen' menunjukkan nilai amountRate adalah persentase numerik. Nilai string 'percent-varies-by-method' menunjukkan biaya adalah persentase yang bervariasi berdasarkan metode pembayaran pelanggan.
notes.feePayment.addedToListPrice boolean Menunjukkan apakah jumlah biaya yang dihitung telah ditambahkan ke harga akhir.
notes.currencyExchangeRate object Menentukan bahwa harga pendaftar terdaftar dalam mata uang nasional lain, dan telah dikonversi ke USD. Rincian konversi mata uang direpresentasikan sebagai:

base: mata uang harga pendaftar sebagai kode 3 huruf (mis. EUR)
quote: mata uang yang dikonversi (akan selalu USD)
rate: nilai tukar yang digunakan untuk membuat konversi mata uang.

Contoh objek catatan currencyExchangeRate: 

{
    "currencyExchangeRate": {
        "base": "GBP",
        "quote": "USD",
        "rate": "1.2482"
    }
}
threeYearValueScore number Pengukuran nilai numerik, yang ditentukan oleh harga dan fitur gratis, untuk memiliki domain dengan ekstensi ini melalui pencatat selama 3 tahun. Semakin besar angkanya, semakin banyak nilai yang ditawarkan.
currency string Kode mata uang ISO 4217 tiga huruf dari data harga. Nilai ini saat ini hanya USD.
freeFeatures array of objects Array objek yang mewakili fitur gratis yang ditawarkan registrar dengan kepemilikan domain. Objek mencakup jumlah dan durasi setiap fitur. Setiap objek dikunci dengan ID fitur gratis:

dns - layanan DNS gratis.
whois-privacy - layanan privasi WHOIS.
email-account - akun email gratis.
email-forward - penerusan email gratis.
ssl-cert - sertifikat SSL dasar gratis.

Contoh larik fitur gratis: 

[
    {
        "name": "dns"
    },
    {
        "name": "whois-privacy"
    },
    {
        "name": "email-account",
        "count": 5
    },
    {
        "name": "ssl-cert",
        "duration": 365
    }
]
freeFeatures[].count number Jumlah fitur yang ditawarkan pendaftar secara gratis. Kolom ini tidak akan ditampilkan jika tidak ada.
freeFeatures[].duration number Jumlah hari fitur ditawarkan secara gratis oleh pendaftar. Jika durasi = 365, maka fitur ditawarkan secara gratis selama 1 tahun. Kolom ini tidak akan muncul jika tidak berlaku.

RegistrarPromo

Menjelaskan promosi aktif yang ditawarkan oleh pendaftar. Contoh: 

{
    "code": "MYCOUPONCODE",
    "amount": "20.00",
    "type": "discount-percent",
    "start": "2015-06-22T00:00:00",
    "end": "2025-06-22T00:00:00"
}
Path Jenis Deskripsi
promo.code string Kode promo yang harus dimasukkan pelanggan pada saat checkout untuk menerima promosi diskon.
promo.amount string Jumlah numerik dari harga promosi. Tergantung pada jenis promo, ini bisa berupa potongan harga(harga), jumlah yang dikurangi dari harga reguler(diskon), atau jumlah persentase yang dikurangi dari harga reguler(persentase diskon).
promo.type string String yang mewakili jenis harga promosi. Akan menjadi salah satu dari nilai berikut:

price - berarti kolom jumlah promo adalah harga diskon baru
discount - berarti kolom jumlah promo dikurangi dari harga reguler untuk mendapatkan harga yang berlaku
discount-percent - berarti kolom jumlah promo adalah persentase, dan persentase dikurangi dari harga reguler untuk mendapatkan harga yang berlaku.
promo.start string Tanggal waktu ISO 8601 (zona waktu UTC) saat promo dimulai. Tidak akan muncul jika tidak ada tanggal mulai yang spesifik. Contoh: 2015-06-22T00:00:00
promo.end string Tanggal waktu ISO 8601 (zona waktu UTC) saat promo akan berakhir. Tidak akan muncul jika tidak ada tanggal akhir yang spesifik. Contoh: 2025-06-22T00:00:00
promo.pricetype array of strings Tipe harga yang berlaku untuk promo ini: register, renewal, transfer.

Catatan: bidang ini hanya ada jika bersarang dalam konteks jenis harga (misalnya, dalam respons dari getCheapestRegistrars).

Kode Kesalahan

Pada kegagalan permintaan, objek respons JSON dapat berisi satu atau beberapa objek kesalahan yang menjelaskan apa yang salah. Di bawah ini adalah daftar yang tidak lengkap untuk mengidentifikasi kode kesalahan yang dapat diatur dalam bidang kode objek kesalahan.

Kode Deskripsi
502 Server API untuk sementara tidak tersedia.
RATE_LIMITED Jumlah permintaan API klien melebihi batas maksimum yang diizinkan.
INVALID_METHOD Metode API yang diminta tidak ada.
SYSTEM Terjadi kesalahan sistem yang tidak diketahui.
RESPONSE_TIMEOUT Server API kehabisan waktu saat menghasilkan respons.
PARAMETER_REQUIRED Parameter yang diperlukan untuk metode yang dipanggil tidak disediakan oleh klien.
ACCOUNT_INACTIVE Akun klien tidak lagi aktif dan pembaruan langganan diperlukan untuk akses API.
NO_ACCESS Level akun klien tidak memberikan akses API. Peningkatan akun diperlukan untuk akses API.
AUTH_INVALID Otentikasi gagal: kunci API yang diberikan tidak aktif atau tidak valid.
CLIENT_IPS_EXCEEDED IP klien unik maksimum yang diizinkan untuk mengakses API untuk pasangan kunci API yang disediakan telah terlampaui.
REQUEST_ENDED_BY_CLIENT Permintaan dihentikan oleh klien sebelum respons dapat dihasilkan.

Batas

Penggunaan API tunduk pada batasan tertentu untuk mencegah penyalahgunaan. Batasan penggunaan ini ditunjukkan di bawah ini dan dapat berubah tanpa pemberitahuan.

Jenis Deskripsi
Kunci API Per Akun 3
Batas Tarif 100 permintaan maksimum per 15 menit
Alamat IP Klien Per Kunci API 5 alamat IP klien unik per kunci per 1440 menit

Metode Penyuluhan

get

Mengembalikan ekstensi dan data harga serta detail terkait. Metode ini mirip dengan mengambil data yang ditampilkan di satu atau beberapa halaman detail TLD (misalnya, .com), dengan pengecualian data "Riwayat Harga Termurah", yang tidak dikembalikan dengan metode ini (lihat metode getAgregateHistory untuk data historis).

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

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

Parameter permintaan

Kunci Jenis Diperlukan Deskripsi
extensions array of strings

Menentukan ekstensi mana yang akan diambil. Jangan menyertakan titik sebelumnya. Nama ekstensi dapat berupa unicode atau punycode yang setara. Jika dihilangkan, semua ekstensi yang terdaftar di TLD-List akan dikembalikan.

Contoh: "extensions": ["com", "io", "co.uk", "移动", "xn--p1ai"]
includeFields array of strings Tentukan data tertentu untuk dikembalikan dengan nama kunci. Kunci yang tidak dimasukkan dalam parameter ini akan dihilangkan. Secara default, semua bidang yang tersedia akan dikembalikan. Lihat tabel respons untuk daftar bidang yang tersedia. Bidang bersarang tidak didukung.

Contoh: "includeFields": ["name", "registrars", "dnssecSupported"]
excludeFields array of strings Tentukan data yang akan dikecualikan berdasarkan nama kunci. Kunci yang dikirimkan dalam parameter ini akan dihilangkan. Secara default, tidak ada field yang dikecualikan. Lihat tabel respons untuk daftar bidang yang tersedia. Bidang bersarang tidak didukung.

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

ID string pendaftar aktif untuk disertakan dalam hasil. Gunakan metode getIds untuk mendapatkan daftar ID dari semua pendaftar yang terdaftar secara aktif di TLD-List.

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

ID string pendaftar aktif yang akan dikecualikan dalam hasil. Gunakan metode getIds untuk mendapatkan daftar ID dari semua pendaftar yang terdaftar secara aktif di TLD-List.

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

Jika benar, ekstensi yang tidak memiliki data harga pencatat dalam hasil akan dihilangkan. Secara default, semua ekstensi disertakan.

Contoh: "omitExtensionsWithoutRegistrars": true

Objek respons

Path Jenis Deskripsi
data array of objects Array nama ekstensi.
data[].available object Objek tanggal ketersediaan fase TLD.
data[].available.general object Tanggal waktu ISO 8601 (zona waktu UTC) saat pendaftaran domain tersedia untuk umum.
data[].available.sunrise object Objek rentang waktu mulai dan akhir yang mewakili fase TLD's Sunrise (saat pemilik merek dagang dapat mulai mengajukan pendaftaran domain yang berlaku). Contoh: 

{
    "sunrise": {
        "start": "2017-06-19T00:00:00.000Z",
        "end": "2017-08-21T00:00:00.000Z"
    }
}
data[].available.trademark object Objek rentang waktu awal dan akhir yang mewakili fase Merek Dagang TLD's (periode ketika pemegang merek dagang akan diberitahu oleh Lembaga Kliring Merek Dagang jika ada domain yang didaftarkan yang cocok dengan merek mereka). Contoh: 

{
    "trademark": {
        "start": "2019-06-18T00:00:00.000Z",
        "end": "2020-09-21T00:00:00.000Z"
    }
}
data[].available.other array of objects Array objek yang mewakili berbagai fase peluncuran TLD dan rentang waktu datetime-nya, seperti "Land Rush" dan "Qualified Launch Program". Contoh: 

{
    "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 Objek yang berisi harga rata-rata ekstensi, berdasarkan jenis harga, untuk pendaftar yang disertakan. Contoh: 

{
    "average": {
        "register": "7.63",
        "renewal": "13.63",
        "transfer": "9.63"
    }
}
data[].average[pricetype] string Harga rata-rata ekstensi sebagai string numerik untuk [pricetype], di mana kunci [pricetype] adalah register, renewal, transfer, restore, whoisprivacy.
data[].category string Kategori yang telah diklasifikasikan oleh TLD. Setiap objek dalam larik mewakili sebuah kategori dan berisi bidang-bidang berikut ini:

id - ID kategori bilangan bulat yang digunakan secara internal oleh TLD-List.
idstr - ID kategori string alternatif.
name - nama kategori dalam bahasa Inggris.
desc - deskripsi kategori dalam bahasa Inggris.

Contoh larik kategori: 

[
    {
        "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 Jika zona DNS registri mendukung Ekstensi Keamanan DNS (DNSSEC).
data[].hasPremiumDomains object Objek kunci [pricetype] dan nilai boolean, yang menunjukkan apakah registri mengenakan harga yang lebih tinggi untuk nama domain "premium" tertentu. Contoh: 

{
    "hasPremiumDomains": {
        "register": false,
        "renewal": false
    }
}
data[].infoUpdated string ISO 8601 datetime (zona waktu UTC) saat info dasar TLD's (batasan, tanggal ketersediaan, dll) terakhir diperiksa dan diperbarui. Catatan: tanggal updated.info yang baru tidak selalu menunjukkan bahwa telah terjadi perubahan data. Tanggal ini hanya menunjukkan kapan data terakhir kali diperiksa dan ditetapkan.
data[].intendedUsage string Informasi umum tentang bagaimana ekstensi diharapkan digunakan oleh pendaftar.
data[].language string Kode bahasa ISO 639-1 2 karakter. Jika bahasa berbasis bahasa Inggris atau tidak dikenal, bidang ini tidak akan ada.
data[].level integer Bilangan bulat yang mewakili tingkat domain ekstensi. 1 = domain tingkat teratas, 2 = domain tingkat kedua, 3 = domain tingkat ketiga, dst.
data[].localPresenceRequired boolean Jika registri mengharuskan pendaftar untuk memiliki alamat fisik lokal di wilayah tersebut.
data[].median object Objek yang berisi harga rata-rata ekstensi, berdasarkan jenis harga, untuk pendaftar yang disertakan. Contoh: 

{
    "median": {
        "register": "3.17",
        "renewal": "20.17",
        "transfer": "8.17"
    }
}
data[].median[pricetype] string Harga rata-rata ekstensi sebagai string numerik untuk [pricetype], di mana kunci [pricetype] adalah register, renewal, transfer, restore, whoisprivacy.
data[].name string Nama Unicode dari ekstensi domain.
data[].nameservers array Server nama akar registri yang menyimpan server nama otoritatif domain terdaftar. Contoh larik server nama: 

{
    "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 Domain tingkat atas induk ekstensi. Jika ini adalah TLD, bidang ini tidak akan muncul.
data[].pricingUpdated string Tanggal waktu ISO 8601 (zona waktu UTC) saat harga registrar TLD's terakhir kali diperiksa dan diperbarui. Catatan: tanggal updated.pricing yang baru tidak selalu menunjukkan bahwa ada perubahan data yang terjadi. Tanggal ini hanya menunjukkan kapan data terakhir kali diperiksa dan ditetapkan.
data[].punycode string Nama punycode dari ekstensi domain. Hanya ada untuk ekstensi IDN.
data[].registerMaxYears integer Tahun maksimum domain dapat didaftarkan pada saat pembelian.
data[].registerMinYears integer Tahun minimum domain dapat didaftarkan pada saat pembelian.
data[].registrarsIncluded integer Jumlah pendaftar yang termasuk dalam array pendaftar yang dikembalikan.
data[].registrarsTotal integer Total pendaftar aktif yang menjual ekstensi.
data[].registrars array of objects Array objek RegistrarPricing yang berisi data harga dan fitur registrar.
data[].registryUrl string Situs web resmi registri untuk informasi pendaftaran TLD.
data[].renewalMinYears integer Tahun minimum yang diperbolehkan untuk memperpanjang domain.
data[].restrictions string Penjelasan singkat tentang batasan dan persyaratan pendaftaran TLD's. Jika tidak ada batasan, kolom ini tidak akan muncul
data[].sponsor object Objek yang berisi data tentang organisasi sponsor atau organisasi pengelola ekstensi.
data[].sponsor.name string Nama organisasi sponsor yang disetujui ICANN atau organisasi pengelola ccTLD.
data[].sponsor.address string Lokasi fisik organisasi sponsor atau organisasi pengelola ccTLD. Contoh susunan alamat: 

{
    "sponsor": {
        "address": [
            "Minerva House",
            "Edmund Halley Road",
            "Oxford Science Park",
            "Oxford OX4 4DQ",
            "United Kingdom"
        ]
    }
}
data[].sponsorParentCompany string Nama entitas yang memiliki kepentingan pengendali dalam organisasi sponsor.
data[].romanized string TLD ditranskripsikan ke dalam karakter latin. Jika bahasa berbasis bahasa Inggris, atau tidak dikenal, bidang ini tidak akan muncul.
data[].rtl string Jika ekstensi dibaca dari "kanan-ke-kiri" (misalnya, Arabric TLDs), nilai ini akan menjadi __true__. Jika dibaca dari "kiri-ke-kanan", nilai ini akan menjadi __false__. Jika tidak diketahui, nilai ini tidak akan ada.
data[].syntax object Objek yang berisi detail tentang aturan dan batasan nama domain yang diizinkan ekstensi.
data[].syntax.minChars integer Jumlah karakter minimum dalam label yang diizinkan untuk didaftarkan.
data[].syntax.maxChars integer Jumlah maksimum karakter dalam label yang diizinkan untuk didaftarkan.
data[].targetMarket string Orang atau entitas yang ingin dilayani oleh TLD.
data[].translation string Terjemahan bahasa Inggris dari TLD. Jika TLD sudah berbasis bahasa Inggris, atau terjemahannya tidak diketahui, nilai ini tidak akan muncul.
data[].type string Jenis TLD diidentifikasi dengan salah satu string berikut ini:

gTLDdomain tingkat atas generik.
ccTLD : domain tingkat atas kode negara.
grTLD: domain tingkat atas yang dibatasi secara umum.
sTLD: domain tingkat atas yang disponsori.
data[].wholesale object Objek yang berisi harga grosir ekstensi berdasarkan jenis harga. Harga grosir adalah harga yang dibebankan oleh registri kepada pencatat untuk pembelian nama domain. Contoh: 

{
    "wholesale": {
        "register": "8.97",
        "renewal": "8.97",
        "transfer": "8.97"
    }
}
data[].whoisPrivacySupported boolean Jika ekstensi mengizinkan layanan Privasi WHOIS untuk menyembunyikan nama dan informasi kontak pendaftar. Jika tidak diketahui, bidang ini tidak akan muncul.
data[].whoisServer boolean Nama host server registri yang menyimpan informasi kontak pendaftar domain.

Contoh permintaan/tanggapan

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

Mengembalikan semua nama ekstensi.

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

Waktu respons:~1 second

Parameter permintaan

Kunci Jenis Diperlukan Deskripsi
omitExtensionsWithoutRegistrars boolean Jika benar, ekstensi yang tidak memiliki data harga pencatat dalam hasil akan dihilangkan. Nilai defaultnya adalah salah.
wantPunycode boolean Mengkodekan semua ekstensi IDN yang dikembalikan sebagai punycode, bukan unicode. Standarnya adalah false.

Objek respons

Path Jenis Deskripsi
data array of strings Array nama ekstensi.

Contoh permintaan/tanggapan

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

Mengembalikan registrar/penyedia termurah, harga, harga rata-rata, dan harga rata-rata per ekstensi domain. Ekstensi yang tidak dijual oleh pencatat mana pun tidak akan dikembalikan.

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

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

Parameter permintaan

Kunci Jenis Diperlukan Deskripsi
pricetypes array of strings

Menentukan jenis harga yang akan diambil. Jika dihilangkan, 3 jenis harga (register, renewal, transfer) akan dikembalikan.

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

Menentukan ekstensi mana yang akan diambil. Jangan menyertakan titik sebelumnya. Nama ekstensi dapat berupa unicode atau punycode yang setara. Jika dihilangkan, semua ekstensi yang terdaftar di TLD-List akan dikembalikan.

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

ID string pendaftar aktif yang akan disertakan saat menentukan harga termurah dan perhitungan agregat. Pendaftar yang tidak ditentukan dalam parameter ini akan diabaikan. Gunakan metode getIds untuk mendapatkan daftar ID semua pendaftar yang terdaftar secara aktif di TLD-List.

Jika parameter ini dihilangkan, semua pendaftar yang terdaftar secara aktif di TLD-List akan dipertimbangkan.

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

ID string pendaftar aktif yang akan dikecualikan saat menentukan harga termurah dan perhitungan agregat. Gunakan metode getIds untuk mendapatkan daftar ID semua pendaftar yang terdaftar secara aktif di TLD-List.

Jika parameter ini dihilangkan, tidak ada pendaftar yang akan diabaikan.

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

Jika benar, ekstensi yang tidak memiliki data harga pencatat dalam hasil akan dihilangkan. Situasi ini terjadi ketika parameter excludeRegistrars dan/atau includeRegistrars yang dilewatkan menyebabkan ekstensi yang biasanya memiliki data harga registrar tidak memiliki data harga registrar yang cocok. Ekstensi ini disertakan secara default, tetapi dengan array kosong untuk data harga mereka. Setel ke true untuk menghilangkan ekstensi ini dari hasil.

Contoh: "omitExtensionsWithoutRegistrars": true

Objek respons

Path Jenis Deskripsi
data array of objects Array objek, masing-masing mewakili ekstensi domain.
data[].name string Nama Unicode dari ekstensi domain.
data[].punycode string Nama punycode dari ekstensi domain. Hanya ada untuk ekstensi IDN.
data[].currency string Kode mata uang ISO 4217 tiga huruf dari data harga. Nilai ini saat ini hanya USD.
data[].registrarsIncluded number Jumlah pendaftar yang termasuk dalam data harga yang dikembalikan.
data[].average object Objek yang berisi harga rata-rata ekstensi, berdasarkan jenis harga, untuk pendaftar yang disertakan.
data[].average[pricetype] string Harga rata-rata ekstensi sebagai string numerik untuk [pricetype], di mana kunci [pricetype] adalah register, renewal, transfer.
data[].median object Objek yang berisi harga rata-rata ekstensi, berdasarkan jenis harga, untuk pendaftar yang disertakan.
data[].median[pricetype] string Harga rata-rata ekstensi sebagai string numerik untuk [pricetype], di mana kunci [pricetype] adalah register, renewal, transfer.
data[].cheapest object Objek yang berisi pendaftar termurah untuk ekstensi berdasarkan jenis harga.
data[].cheapest[pricetype] array of objects

Array objek RegistrarPricing yang berisi registrar termurah menurut [pricetype], di mana kunci [pricetype] adalah register, renewal, transfer.

Data ini berupa array karena harga termurah untuk ekstensi bisa jadi sama di beberapa pencatat.

Contoh permintaan/tanggapan

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

Metode Pendaftar

getIds

Mengembalikan semua ID pendaftar, yang masing-masing secara unik mengidentifikasi pendaftar yang secara aktif terdaftar di TLD-List.

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

Waktu respons:< 1 second

Parameter permintaan

Tidak ada

Objek respons

Path Jenis Deskripsi
data array of strings Array ID pendaftar string.

Contoh permintaan/tanggapan

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