Documentazione API v1

Informazioni sui metodi supportati, parametri, dati restituiti ed esempi.

Avvertimento: L'API è attualmente in fase di sviluppo e soggetta a funzionalità aggiunte: nuovi metodi e parametri potrebbero essere aggiunti in futuro. Qualsiasi modifica apportata rimarrà compatibile con le funzionalità esistenti.

Panoramica

L'API TLD-List v1 può essere utilizzata per recuperare i dati visualizzati su TLD-List dal suo database live.

L'API accetta HTTP POST contenenti dati JSON e risponde con dati JSON. Requisiti per tutte le richieste di metodi API:

  • Le richieste devono essere effettuate con il metodo HTTP POST.
  • Le richieste devono avere un corpo JSON contenente una coppia di chiavi API pubbliche e private valide per l'autenticazione.
  • Le richieste devono includere l'intestazione: Tipo di contenuto: application/json

I parametri vengono passati all'API come chiavi/valori nel corpo della richiesta codificata JSON.

L'URL di base per tutte le richieste API è:

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

Autenticazione

L'autenticazione viene eseguita passando una chiave API pubblica e una chiave API privata nel corpo JSON inviato all'URL del metodo. Tutte le chiamate API devono includere una coppia di chiavi API valida. Le coppie di chiavi API possono essere generate nel suo account TLD-List, nella scheda API.

Visiti il sito Account > API per creare le chiavi API.

Le chiavi API vengono passate nel corpo della richiesta JSON utilizzando i parametri apiKeyPublic (la sua chiave pubblica) e apiKeyPrivate (la sua chiave privata).

Example authentication parameters

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

Risposta

Tutte le risposte API di successo avranno un codice di stato HTTP 200 SUCCESS e un corpo codificato JSON. Qualsiasi altro codice di stato HTTP nella risposta indica che la richiesta non è andata a buon fine e che si è verificato un errore.

Gli oggetti di risposta JSON restituiti dall'API avranno la seguente struttura:

Chiave Tipo Descrizione
status string Specifica lo stato della richiesta. SUCCESS indica che la chiamata API ha avuto successo, FAIL indica che la richiesta è fallita.
errors array of objects Array di oggetti che rappresentano gli errori che si sono verificati. Ogni oggetto errore conterrà:

codice: stringa che identifica il tipo di errore

messaggio: stringa leggibile dall'uomo che descrive l'errore

parametro: stringa o array di stringhe opzionale che indica un problema con uno o più parametri passati nella richiesta.

Se non si sono verificati errori, l'array degli errori sarà vuoto.

Per maggiori informazioni, consulti i codici di errore.
seconds number Tempo impiegato dal server API per generare una risposta (in secondi).
data string|array|object Un oggetto, un array o una stringa contenente i dati richiesti.

Esempio di oggetto di risposta fallito con errori

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

Esempio di oggetto di risposta di successo

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

Oggetti di risposta comuni

Alcuni dei metodi API restituiscono oggetti di dati che hanno la stessa struttura. Questi oggetti di dati comuni sono descritti in dettaglio di seguito.

RegistrarPricing

Descrive i prezzi al dettaglio di una società di registrazione per un'estensione per un particolare tipo di prezzo (register, renewal, transfer), inclusi dettagli aggiuntivi come termini speciali, tariffe, tasse e promozioni.

Percorso Tipo Descrizione
id string Stringa dell'ID della società di registrazione che identifica in modo univoco la società di registrazione.
name string Nome visualizzato della società di registrazione.
price string Il prezzo di vendita finale della società di registrazione per l'estensione e il tipo di prezzo.

Nota: questo campo è presente solo quando l'oggetto RegistrarPricing è annidato nel contesto di un tipo di prezzo (ad esempio, nella risposta di getCheapestRegistrars).
priceOriginal string Il prezzo di vendita regolare della società di registrazione per l'estensione, come stringa numerica. Questo campo sarà presente solo se il prezzo è un prezzo promozionale.

Nota: questo campo è presente solo quando l'oggetto RegistrarPricing è annidato nel contesto di un tipo di prezzo (ad esempio, nella risposta di getCheapestRegistrars).
pricetype string Il tipo di prezzo dell'estensione, uno dei seguenti: register, renewal, transfer.

Nota: questo campo è presente solo quando l'oggetto RegistrarPricing è annidato nel contesto di un tipo di prezzo (ad esempio, nella risposta di getCheapestRegistrars).
prices object Il prezzo al dettaglio del registrar per l'estensione per tutti i tipi di prezzo.
prices[pricetype] string Il prezzo di vendita finale del registrar per l'estensione e [pricetype], dove la chiave [pricetype] è register, renewal, transfer, restore, whoisprivacy. Esempio:

{
    "register": "8.73",
    "renewal": "9.73",
    "transfer": "9.73",
    "whoisPrivacy": "0.00"
}
pricesOriginal object Il prezzo al dettaglio regolare della società di registrazione per l'estensione, per tutti i tipi di prezzo. Questo campo non sarà presente se la società di registrazione non ha promozioni attive.
pricesOriginal[pricetype] string Il prezzo di vendita regolare del registrar per l'estensione e [pricetype], dove la chiave [pricetype] è register, renewal, transfer, restore, whoisprivacy.
promo object Un oggetto RegistrarPromo che rappresenta il prezzo promozionale che è stato applicato al prezzo della società di registrazione per questa estensione e questo tipo di prezzo. Se non è stata applicata alcuna promo, questo campo non sarà presente. Esempio di oggetto promo: 

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


Nota: questo campo è presente solo quando l'oggetto RegistrarPricing è annidato nel contesto di un tipo di prezzo (ad esempio, nella risposta di getCheapestRegistrars).
promos array of objects Array di oggetti RegistrarPromo che rappresentano tutte le tariffe promozionali attive offerte dalla società di registrazione per questa estensione.
terms object Una collezione di oggetti che rappresentano i termini speciali che si applicano alla tariffazione della società di registrazione. Se non si applicano termini speciali, questo campo non sarà presente. Ogni oggetto secondario è codificato con un ID di termine:

limitPerCustomer - specifica che il prezzo è valido solo per un certo numero di domini per cliente.
newCustomerOnly - specifica che il prezzo è valido solo per i nuovi clienti.
affiliateLink - specifica che il prezzo è valido solo quando il cliente accede al sito della società di registrazione tramite un link affiliato.
nameserverLockIn - specifica che i domini acquistati possono utilizzare solo i nameserver della società di registrazione.
idSubmissionRequired - specifica che il cliente deve presentare il proprio documento d'identità con foto o la propria registrazione aziendale per completare l'acquisto.

Esempi di oggetti termini: 

{
    "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 La quantità a cui il termine limita il cliente. Per esempio, se il conteggio è = 1, il cliente è limitato a 1 dominio al prezzo specificato. Questo campo non sarà presente se non è applicabile.
terms[term].pricetype array of strings Il tipo o i tipi di prezzo a cui si applica il termine: register, renewal, transfer. Questo campo sarà presente solo se il tipo di prezzo dell'oggetto RegistrarPricing non è specificato.
notes object Una raccolta di oggetti che rappresentano le note che riguardano la tariffazione della società di registrazione. Se non ci sono note di tariffazione, questo valore sarà un oggetto vuoto. Ogni sottooggetto è codificato con un ID di nota: currencyExchangeRate, feeIcann, feeTax, feePayment
notes.feeIcann object Specifica se una tassa ICANN è stata aggiunta al prezzo finale del TLD (in genere 0,18 dollari USD). Se questa nota esiste, significa che la società di registrazione non include la tassa ICANN nel suo prezzo pubblicizzato, ma la aggiunge come tassa aggiuntiva al prezzo TLD's al momento del checkout del cliente.

Esempio di oggetto nota fee_icann: 

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

Il campo pricetype specifica quali tipi di prezzo sono soggetti alla tariffa e il campo addedToListPrice indica che la tariffa è stata aggiunta al prezzo finale.
notes.feeTax array of objects Specifica le varie aliquote fiscali applicate da una società di registrazione, i clienti a cui si applica l'imposta e se l'imposta calcolata è stata inclusa nel prezzo finale del TLD. Si prega di notare che le tasse sono incluse nel prezzo finale del TLD solo se la società di registrazione non include le tasse nei suoi prezzi pubblicizzati e se le tasse sono applicate a tutti i clienti.

Esempio di array di oggetti feeTax: 

{
    "feeTax": [
        {
            "addedToListPrice": false,
            "appliesToCustomers": [
                "eu",
                "us",
                "in"
            ],
            "amountRateType": "percent",
            "amountRate": "13",
            "type": "hst"
        },
        {
            "addedToListPrice": false,
            "appliesToCustomers": [
                "ca"
            ],
            "amountRateType": "percent",
            "amountRate": "5",
            "type": "gst"
        }
    ]
}
notes.feeTax[].type string Etichetta che descrive il tipo di imposta, ad esempio 'vat' per l'Imposta sul Valore Aggiunto, 'gst' per l'Imposta sui Beni e Servizi, ecc.
notes.feeTax[].amountRate number|string Importo dell'aliquota fiscale. Si tratta della percentuale d'imposta come numero, oppure della stringa '~' che indica che l'aliquota d'imposta varia in base ai criteri del cliente, come la località.
notes.feeTax[].amountRateType string Il valore stringa 'percent' indica che il valore amountRate è una percentuale numerica. Il valore stringa 'percent-varies-by-location' indica che l'aliquota fiscale varia in base alla regione o al Paese di fatturazione del cliente.
notes.feeTax[].appliesToCustomers string|array of strings la stringa '*' indica che la tassa si applica a tutti i clienti. Altrimenti, questo valore sarà un array di stringhe di codici paese ISO 3166-1 alpha-2 che definiscono quali Paesi sono soggetti all'imposta. Un'eccezione da notare: l'array può contenere la stringa di codice non paese 'eu', che rappresenta tutti i Paesi dell'Unione Europea.
notes.feeTax[].addedToListPrice boolean Indica se l'importo dell'imposta calcolata è stato aggiunto al prezzo finale.
notes.feePayment object Specifica se la società di registrazione addebita una tariffa aggiuntiva in base al metodo di pagamento del cliente e se la tariffa è stata inclusa nel prezzo finale del TLD.
Esempio di oggetto feePayment: 

{
    "feePayment": {
        "addedToListPrice": false,
        "amountRate": "~",
        "amountRateMin": "0.9",
        "amountRateMax": "20",
        "amountRateType": "percent-varies-by-method"
    }
}
notes.feePayment.amountRate string Importo della tassa. Questo sarà il tasso percentuale della tassa come numero, oppure la stringa '~' che indica che il tasso della tassa varia in base ai criteri del cliente, come il metodo di pagamento.
notes.feePayment.amountRateMin string Importo minimo della tariffa, si applica solo se la tariffa è variabile.
notes.feePayment.amountRateMax string Importo massimo della tassa, si applica solo se la tassa è variabile.
notes.feePayment.amountRateType string Il valore stringa 'percent' indica che il valore amountRate è una percentuale numerica. Il valore stringa 'percent-varies-by-method' indica che la tariffa è una percentuale che varia in base al metodo di pagamento del cliente.
notes.feePayment.addedToListPrice boolean Indica se l'importo della tassa calcolata è stato aggiunto al prezzo finale.
notes.currencyExchangeRate object Specifica che i prezzi della società di registrazione erano quotati in un'altra valuta nazionale e sono stati convertiti in USD. I dettagli della conversione di valuta sono rappresentati come:

base: la valuta di quotazione della società di registrazione come codice di 3 lettere (ad esempio EUR)
quota: la valuta in cui sono stati convertiti i prezzi (sarà sempre USD)
tasso: il tasso di cambio utilizzato per effettuare la conversione di valuta.

Esempio di oggetto nota currencyExchangeRate: 

{
    "currencyExchangeRate": {
        "base": "GBP",
        "quote": "USD",
        "rate": "1.2482"
    }
}
threeYearValueScore number Una misura numerica del valore, determinata dal prezzo e dalle funzioni gratuite, per possedere un dominio con questa estensione tramite il registrar per un periodo di 3 anni. Più grande è il numero, maggiore è il valore offerto.
currency string Il codice di valuta a tre lettere ISO 4217 dei dati di tariffazione. Questo valore è attualmente solo USD.
freeFeatures array of objects Un array di oggetti che rappresentano le funzionalità gratuite che la società di registrazione offre con la proprietà del dominio. L'oggetto include la quantità e la durata di ciascuna funzionalità. Ogni oggetto è codificato con un ID di funzionalità gratuita:

dns - servizio DNS gratuito.
whois-privacy - servizio di privacy WHOIS.
email-account - account e-mail gratuito/i.
email-forward - inoltro e-mail gratuito.
ssl-cert - certificato/i SSL di base gratuito/i.

Esempio di array di funzionalità gratuite: 

[
    {
        "name": "dns"
    },
    {
        "name": "whois-privacy"
    },
    {
        "name": "email-account",
        "count": 5
    },
    {
        "name": "ssl-cert",
        "duration": 365
    }
]
freeFeatures[].count number La quantità della funzione che la società di registrazione offre gratuitamente. Questo campo non sarà presente se non è applicabile.
freeFeatures[].duration number Il numero di giorni in cui la funzione è offerta gratuitamente dalla società di registrazione. Se la durata = 365, la funzione è offerta gratuitamente per 1 anno. Questo campo non sarà presente se non è applicabile.

RegistrarPromo

Descrive una promozione attiva offerta da una società di registrazione. Esempio: 

{
    "code": "MYCOUPONCODE",
    "amount": "20.00",
    "type": "discount-percent",
    "start": "2015-06-22T00:00:00",
    "end": "2025-06-22T00:00:00"
}
Percorso Tipo Descrizione
promo.code string Il codice promozionale che il cliente deve inserire al momento del checkout per ricevere la promozione scontata.
promo.amount string L'importo numerico del prezzo promozionale. A seconda del tipo di promo, potrebbe trattarsi del prezzo scontato(prezzo), dell'importo sottratto al prezzo normale(sconto) o dell'importo percentuale sottratto al prezzo normale(sconto-percentuale).
promo.type string Una stringa che rappresenta il tipo di prezzo promozionale. Sarà uno dei seguenti valori:

prezzo - significa che il campo importo della promo è il nuovo prezzo scontato
sconto - significa che il campo importo della promo è stato sottratto dal prezzo regolare per ottenere il prezzo applicato
sconto-percentuale - significa che il campo importo della promo è una percentuale e la percentuale è stata sottratta dal prezzo regolare per ottenere il prezzo applicato.
promo.start string Data ISO 8601 (fuso orario UTC) di quando è iniziata la promo. Non sarà presente se non c'è una data di inizio specifica. Esempio: 2015-06-22T00:00:00
promo.end string Data ISO 8601 (fuso orario UTC) di quando terminerà la promo. Non sarà presente se non c'è una data finale specifica. Esempio: 2025-06-22T00:00:00
promo.pricetype array of strings Il tipo o i tipi di prezzo a cui si applica la promo: register, renewal, transfer.

Nota: questo campo è presente solo se annidato nel contesto di un tipo di prezzo (ad esempio, nella risposta di getCheapestRegistrars).

Codici di errore

In caso di fallimento della richiesta, l'oggetto di risposta JSON può contenere uno o più oggetti di errore che descrivono cosa è andato storto. Di seguito è riportato un elenco non esaustivo di codici di errore identificativi che possono essere impostati nel campo codice dell'oggetto error.

Codice Descrizione
502 Il server API è temporaneamente non disponibile.
RATE_LIMITED Il numero di richieste API del cliente ha superato il massimo consentito.
INVALID_METHOD Il metodo API richiesto non esiste.
SYSTEM Si è verificato un errore di sistema sconosciuto.
RESPONSE_TIMEOUT Il server API si è bloccato durante la generazione di una risposta.
PARAMETER_REQUIRED Un parametro richiesto per il metodo chiamato non è stato fornito dal cliente.
ACCOUNT_INACTIVE L'account del cliente non è più attivo e per l'accesso all'API è necessario rinnovare l'abbonamento.
NO_ACCESS Il livello dell'account del cliente non garantisce l'accesso all'API. Per l'accesso all'API è necessario un aggiornamento dell'account.
AUTH_INVALID Autenticazione fallita: le chiavi API fornite sono inattive o non valide.
CLIENT_IPS_EXCEEDED È stato superato il numero massimo di IP unici del cliente autorizzati ad accedere all'API per la coppia di chiavi API fornita.
REQUEST_ENDED_BY_CLIENT La richiesta è stata terminata dal cliente prima che potesse essere generata una risposta.

Limiti

L'utilizzo dell'API è soggetto a determinati limiti per evitare abusi. Questi limiti di utilizzo sono indicati di seguito e sono soggetti a modifiche senza preavviso.

Tipo Descrizione
Chiavi API per account 3
Limite del tasso 100 richieste massime per 15 minuti
Indirizzi IP del cliente per chiave API 5 indirizzi IP unici del cliente per chiave per 1440 minuti

Metodi di estensione

get

Restituisce le estensioni e i dati relativi ai prezzi e ai dettagli ad esse associati. Questo metodo è simile al recupero dei dati visualizzati su una o più pagine di dettagli del TLD (ad esempio, .com), ad eccezione dei dati della "Storia del prezzo più conveniente", che non vengono restituiti da questo metodo (vedere il metodo getAggregateHistory per i dati storici).

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

Tempo di risposta:~12 seconds for all extensions, ~6 seconds < 2000 extensions, ~2 seconds < 100 extensions

Parametri della richiesta

Chiave Tipo Richiesto Descrizione
extensions array of strings

Specifica quali estensioni recuperare. Non includa un punto precedente. I nomi delle estensioni possono essere unicode o il loro equivalente punycode. Se omesso, verranno restituite tutte le estensioni elencate in TLD-List.

Esempio: "extensions": ["com", "io", "co.uk", "移动", "xn--p1ai"]
includeFields array of strings Specifica alcuni dati da restituire in base al nome della chiave. Le chiavi non presentate in questo parametro saranno omesse. Per impostazione predefinita, vengono restituiti tutti i campi disponibili. Consulti la tabella delle risposte per un elenco dei campi disponibili. I campi annidati non sono supportati.

Esempio: "includeFields": ["name", "registrars", "dnssecSupported"]
excludeFields array of strings Specifica i dati di cetain da escludere in base al nome della chiave. Le chiavi presentate in questo parametro saranno omesse. Per impostazione predefinita, nessun campo viene escluso. Consulti la tabella delle risposte per un elenco dei campi disponibili. I campi annidati non sono supportati.

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

Gli ID stringa delle società di registrazione attive da includere nei risultati. Utilizzi il metodo getIds per ottenere un elenco di ID di tutte le società di registrazione attive su TLD-List.

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

La stringa degli ID delle società di registrazione attive da escludere nei risultati. Utilizzi il metodo getIds per ottenere un elenco di ID di tutte le società di registrazione attive su TLD-List.

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

Quando è vero, le estensioni che non hanno dati sui prezzi della società di registrazione nei risultati vengono omesse. Per impostazione predefinita, tutte le estensioni sono incluse.

Esempio: "omitExtensionsWithoutRegistrars": true

Oggetto della risposta

Percorso Tipo Descrizione
data array of objects Array di nomi di estensioni.
data[].available object Oggetto delle date di disponibilità della fase TLD.
data[].available.general object Data ISO 8601 (fuso orario UTC) di quando la registrazione del dominio è disponibile al pubblico.
data[].available.sunrise object Oggetto di intervalli di date iniziali e finali che rappresentano la fase di Sunrise di TLD's (quando i proprietari di marchi possono iniziare a richiedere la registrazione dei domini applicabili). Esempio: 

{
    "sunrise": {
        "start": "2017-06-19T00:00:00.000Z",
        "end": "2017-08-21T00:00:00.000Z"
    }
}
data[].available.trademark object Oggetto di intervalli di date iniziali e finali che rappresentano la fase del marchio TLD's (periodo in cui i titolari del marchio saranno avvisati dalla Trademark Clearinghouse se viene registrato un dominio corrispondente al loro marchio). Esempio: 

{
    "trademark": {
        "start": "2019-06-18T00:00:00.000Z",
        "end": "2020-09-21T00:00:00.000Z"
    }
}
data[].available.other array of objects Array di oggetti che rappresentano le varie fasi di lancio del TLD e i relativi intervalli di tempo, come "Land Rush" e "Qualified Launch Program". Esempio: 

{
    "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 Oggetto contenente il prezzo medio dell'estensione, per tipo di prezzo, per le società di registrazione incluse. Esempio: 

{
    "average": {
        "register": "7.63",
        "renewal": "13.63",
        "transfer": "9.63"
    }
}
data[].average[pricetype] string Il prezzo medio dell'estensione come stringa numerica per [tipo di prezzo], dove la chiave [tipo di prezzo] è register, renewal, transfer, restore, whoisprivacy.
data[].category string Le categorie in cui il TLD è stato classificato. Ogni oggetto dell'array rappresenta una categoria e contiene i seguenti campi:

id - ID della categoria di tipo intero utilizzato internamente da TLD-List.
idstr - ID della categoria di tipo stringa alternativa.
name - nome della categoria in inglese.
desc - descrizione della categoria in inglese.

Esempio di array di categorie: 

[
    {
        "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 Se la zona DNS del registro supporta le Estensioni di sicurezza DNS (DNSSEC).
data[].hasPremiumDomains object Oggetto di chiavi [pricetype] e valori booleani, che rappresentano se il registro applica prezzi più alti per selezionare nomi di dominio "premium". Esempio: 

{
    "hasPremiumDomains": {
        "register": false,
        "renewal": false
    }
}
data[].infoUpdated string Data ISO 8601 (fuso orario UTC) dell'ultimo controllo e aggiornamento delle informazioni di base di TLD's (restrizioni, date di disponibilità, ecc.). Nota: una nuova data updated.info non indica necessariamente che si sia verificata una modifica dei dati. Indica solo quando i dati sono stati controllati e impostati per l'ultima volta.
data[].intendedUsage string Informazioni generali su come si prevede che l'estensione venga utilizzata dai registranti.
data[].language string Il codice della lingua ISO 639-1 a 2 caratteri. Se la lingua è inglese o sconosciuta, questo campo non sarà presente.
data[].level integer Un intero che rappresenta il livello di dominio dell'estensione. 1 = dominio di primo livello, 2 = dominio di secondo livello, 3 = dominio di terzo livello, ecc.
data[].localPresenceRequired boolean Se il registro richiede che il registrante abbia un indirizzo fisico locale nella regione.
data[].median object Oggetto contenente il prezzo mediano dell'estensione, per tipo di prezzo, per le società di registrazione incluse. Esempio: 

{
    "median": {
        "register": "3.17",
        "renewal": "20.17",
        "transfer": "8.17"
    }
}
data[].median[pricetype] string Il prezzo mediano dell'estensione come stringa numerica per [tipo di prezzo], dove la chiave [tipo di prezzo] è register, renewal, transfer, restore, whoisprivacy.
data[].name string Nome Unicode dell'estensione del dominio.
data[].nameservers array I server dei nomi radice del registro che memorizzano i server dei nomi autorevoli dei domini registrati. Esempio di array di nameserver: 

{
    "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 Il dominio di primo livello padre dell'estensione. Se si tratta di un TLD, questo campo non sarà presente.
data[].pricingUpdated string Data ISO 8601 (fuso orario UTC) dell'ultimo controllo e aggiornamento dei prezzi della società di registrazione TLD's. Nota: una nuova data aggiornata.pricing non indica necessariamente che si è verificata una modifica dei dati. Indica solo quando i dati sono stati controllati e impostati per l'ultima volta.
data[].punycode string Nome in codice puntato dell'estensione del dominio. Presente solo per le estensioni IDN.
data[].registerMaxYears integer Anni massimi in cui un dominio può essere registrato al momento dell'acquisto.
data[].registerMinYears integer Anni minimi in cui un dominio può essere registrato al momento dell'acquisto.
data[].registrarsIncluded integer Conteggio delle società di registrazione incluse nell'array di società di registrazione restituito.
data[].registrarsTotal integer Totale dei registrar attivi che vendono l'estensione.
data[].registrars array of objects Array di oggetti RegistrarPricing contenenti i dati relativi ai prezzi e alle caratteristiche della società di registrazione.
data[].registryUrl string Il sito web ufficiale del Registro per le informazioni sulla registrazione dei TLD.
data[].renewalMinYears integer Anni minimi consentiti per il rinnovo di un dominio.
data[].restrictions string Una breve descrizione delle restrizioni e dei requisiti di registrazione di TLD's. Se non ci sono restrizioni, questo campo non sarà presente.
data[].sponsor object Oggetto contenente dati sull'organizzazione promotrice o sull'organizzazione di gestione dell'estensione.
data[].sponsor.name string Il nome dell'organizzazione sponsor dell'estensione approvata dall'ICANN o dell'organizzazione di gestione ccTLD.
data[].sponsor.address string Sede fisica dell'organizzazione promotrice o dell'organizzazione di gestione ccTLD. Esempio di array di indirizzi: 

{
    "sponsor": {
        "address": [
            "Minerva House",
            "Edmund Halley Road",
            "Oxford Science Park",
            "Oxford OX4 4DQ",
            "United Kingdom"
        ]
    }
}
data[].sponsorParentCompany string Nome dell'entità che detiene il controllo dell'organizzazione sponsor.
data[].romanized string Il TLD trascritto in caratteri latini. Se la lingua è inglese o sconosciuta, questo campo non sarà presente.
data[].rtl string Se l'estensione viene letta da "destra a sinistra" (cioè Arabric TLDs), questo valore sarà __true__. Se viene letta da "sinistra a destra", questo valore sarà __false__. Se è sconosciuto, questo valore non sarà presente.
data[].syntax object Oggetto contenente i dettagli sulle regole e le restrizioni del nome di dominio consentito dell'estensione.
data[].syntax.minChars integer Numero minimo di caratteri dell'etichetta consentiti per la registrazione.
data[].syntax.maxChars integer Numero massimo di caratteri dell'etichetta che possono essere registrati.
data[].targetMarket string Le persone o le entità che il TLD è destinato a servire.
data[].translation string La traduzione in inglese del TLD. Se il TLD è già basato sull'inglese, o la traduzione è sconosciuta, questo valore non sarà presente.
data[].type string Il tipo di TLD identificato da una delle seguenti stringhe:

gTLD: dominio di primo livello generico.
ccTLD : dominio di primo livello country-code.
grTLD: dominio di primo livello generico-limitato.
sTLD: dominio di primo livello sponsorizzato.
data[].wholesale object Oggetto contenente i prezzi all'ingrosso dell'estensione per tipo di prezzo. I prezzi all'ingrosso sono i prezzi applicati dal registro a una società di registrazione per l'acquisto di nomi di dominio. Esempio: 

{
    "wholesale": {
        "register": "8.97",
        "renewal": "8.97",
        "transfer": "8.97"
    }
}
data[].whoisPrivacySupported boolean Se l'estensione consente ai servizi WHOIS Privacy di mascherare i nomi e le informazioni di contatto dei registranti. Se è sconosciuto, questo campo non sarà presente.
data[].whoisServer boolean Nome host del server del registro che memorizza le informazioni di contatto del registrante del dominio.

Esempio di richiesta/risposta

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

Restituisce tutti i nomi delle estensioni.

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

Tempo di risposta:~1 second

Parametri della richiesta

Chiave Tipo Richiesto Descrizione
omitExtensionsWithoutRegistrars boolean Quando è vero, le estensioni che non hanno dati sui prezzi della società di registrazione nei risultati vengono omesse. Il valore predefinito è falso.
wantPunycode boolean Codifica tutte le estensioni IDN restituite come punycode anziché unicode. L'impostazione predefinita è false.

Oggetto della risposta

Percorso Tipo Descrizione
data array of strings Array di nomi di estensioni.

Esempio di richiesta/risposta

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

Restituisce i registrar/provider più economici, i loro prezzi, il prezzo mediano e il prezzo medio per estensione di dominio. Le estensioni che non sono vendute da nessun registrar non vengono restituite.

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

Tempo di risposta:~8 seconds for all extensions, ~4 seconds < 2000 extensions, ~1 second < 100 extensions

Parametri della richiesta

Chiave Tipo Richiesto Descrizione
pricetypes array of strings

Specifica i tipi di prezzi da recuperare. Se omesso, vengono restituiti 3 tipi di prezzo (register, renewal, transfer).

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

Specifica quali estensioni recuperare. Non includa un punto precedente. I nomi delle estensioni possono essere unicode o il loro equivalente punycode. Se omesso, verranno restituite tutte le estensioni elencate in TLD-List.

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

Gli ID stringa delle società di registrazione attive da includere nella determinazione dei prezzi più convenienti e nei calcoli aggregati. Le società di registrazione non specificate in questo parametro saranno ignorate. Utilizzi il metodo getIds per ottenere un elenco di ID di tutte le società di registrazione attivamente elencate su TLD-List.

Se questo parametro viene omesso, verranno considerate tutte le società di registrazione attivamente elencate su TLD-List.

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

Gli ID stringa delle società di registrazione attive da escludere per determinare i prezzi più convenienti e i calcoli aggregati. Utilizzi il metodo getIds per ottenere un elenco di ID di tutte le società di registrazione attive su TLD-List.

Se questo parametro viene omesso, nessuna società di registrazione verrà ignorata.

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

Quando è vero, le estensioni che non hanno dati sui prezzi della società di registrazione nei risultati vengono omesse. Questa situazione si verifica quando i parametri excludeRegistrars e/o includeRegistrars passati hanno fatto sì che un'estensione che normalmente ha dati sui prezzi della società di registrazione non abbia dati corrispondenti sui prezzi della società di registrazione. Queste estensioni sono incluse per impostazione predefinita, ma con array vuoti per i loro dati tariffari. Impostare su true per omettere queste estensioni dai risultati.

Esempio: "omitExtensionsWithoutRegistrars": true

Oggetto della risposta

Percorso Tipo Descrizione
data array of objects Array di oggetti, ognuno dei quali rappresenta un'estensione di dominio.
data[].name string Nome Unicode dell'estensione del dominio.
data[].punycode string Nome in codice puntato dell'estensione del dominio. Presente solo per le estensioni IDN.
data[].currency string Il codice di valuta a tre lettere ISO 4217 dei dati di tariffazione. Questo valore è attualmente solo USD.
data[].registrarsIncluded number Conteggio delle società di registrazione incluse nei dati di prezzo restituiti.
data[].average object Oggetto contenente il prezzo medio dell'estensione, per tipo di prezzo, per i registrar inclusi.
data[].average[pricetype] string Il prezzo medio dell'estensione come stringa numerica per [tipo di prezzo], dove la chiave [tipo di prezzo] è register, renewal, transfer.
data[].median object Oggetto contenente il prezzo mediano dell'estensione, per tipo di prezzo, per i registrar inclusi.
data[].median[pricetype] string Il prezzo mediano dell'estensione come stringa numerica per [tipo di prezzo], dove la chiave [tipo di prezzo] è register, renewal, transfer.
data[].cheapest object Oggetto contenente le società di registrazione più economiche per l'estensione in base al tipo di prezzo.
data[].cheapest[pricetype] array of objects

Array di oggetti RegistrarPricing contenenti le società di registrazione più economiche in base a [pricetype], dove la chiave [pricetype] è register, renewal, transfer.

Questi dati sono un array perché il prezzo più economico per l'estensione potrebbe essere lo stesso tra più società di registrazione.

Esempio di richiesta/risposta

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

Metodi di registrazione

getIds

Restituisce tutti gli ID della società di registrazione, ognuno dei quali identifica in modo univoco una società di registrazione attivamente quotata su TLD-List.

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

Tempo di risposta:< 1 second

Parametri della richiesta

Nessuno

Oggetto della risposta

Percorso Tipo Descrizione
data array of strings Array di stringhe di ID della società di registrazione.

Esempio di richiesta/risposta

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