Riferimento API

API Intelligenza TLD

Ottieni intelligenza dettagliata su un TLD inclusi prezzi, restrizioni, supporto registrar e statistiche di utilizzo. Usa questo riferimento per scegliere l'endpoint giusto e vedere esattamente cosa restituisce.

Operazioni

GET /v1/tlds/:tld Vedi il riferimento API

GET /v1/tlds

Operazione: getTlds Crediti e autenticazione: Gratis Autenticazione facoltativa
GET /v1/tlds Crediti: 0

Parametri di query

Parametro Tipo obbligatorio
type string
Valori consentiti gtldcctldnew-gtldidn
facoltativo
trust_tier string
Valori consentiti premiumstandardeconomysuspicious
facoltativo
use_case string facoltativo

Campi della risposta

Campo Tipo
tlds[] object[]
tlds[] object
tlds[].tld string
tlds[].type string
tlds[].name string
tlds[].rdap_supported boolean
tlds[].trust_tier string
tlds[].popularity_rank integer
tlds[].registration_usd number
total integer
by_type object
by_type.gTLD integer
by_type.ccTLD integer
by_type.newTLD integer
by_type.idn integer
by_trust_tier object
by_trust_tier.premium integer
by_trust_tier.standard integer
by_trust_tier.economy integer
use_case string
meta object

Richiesta di esempio

curl "https://domscan.net/v1/tlds?type=gtld&trust_tier=premium&use_case=startup"
const response = await fetch("https://domscan.net/v1/tlds?type=gtld&trust_tier=premium&use_case=startup");
const data = await response.json();
console.log(data);
import requests

response = requests.get(
    "https://domscan.net/v1/tlds?type=gtld&trust_tier=premium&use_case=startup",
)
print(response.json())
package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/tlds?type=gtld&trust_tier=premium&use_case=startup", nil)
	if err != nil {
		panic(err)
	}

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	data, err := io.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(resp.Status, string(data))
}
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/tlds?type=gtld&trust_tier=premium&use_case=startup")
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))

Risposta di esempio

{
  "tlds": [
    {
      "tld": "com",
      "type": "gTLD",
      "name": "example",
      "rdap_supported": false,
      "trust_tier": "premium",
      "popularity_rank": 1,
      "registration_usd": 0.5
    }
  ],
  "total": 1,
  "by_type": {
    "gTLD": 1,
    "ccTLD": 1,
    "newTLD": 1,
    "idn": 1
  },
  "by_trust_tier": {
    "premium": 1,
    "standard": 1,
    "economy": 1
  },
  "use_case": "example",
  "meta": {}
}

Codici di stato HTTP

  • 200 OK
  • 429 Troppe richieste

GET /v1/tlds/:tld

Operazione: getTldDetail Crediti e autenticazione: 1 Autenticazione richiesta
GET /v1/tlds/:tld Crediti: 1

Parametri di query

Parametro Tipo obbligatorio
tld string obbligatorio

Campi della risposta

Campo Tipo
tld string
type string
name string
description string
introduced integer
operator string | null
country string | null
restrictions string
rdap_supported boolean
rdap_endpoint string | null
idn_supported boolean
dnssec_supported boolean
pricing object
pricing.registration_usd number
pricing.renewal_usd number
pricing.transfer_usd number
pricing.currency string
pricing.source string
popularity object
popularity.rank integer
popularity.tier string
popularity.use_cases[] string[]
trust object
trust.score number
trust.tier string
trust.notes string | null
meta object

Richiesta di esempio

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/tlds/com"
const response = await fetch("https://domscan.net/v1/tlds/com", {
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);
import os
import requests

response = requests.get(
    "https://domscan.net/v1/tlds/com",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())
package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/tlds/com", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	data, err := io.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(resp.Status, string(data))
}
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/tlds/com")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))

Risposta di esempio

{
  "tld": "com",
  "type": "gTLD",
  "name": "Commercial",
  "description": "The most popular and trusted domain extension worldwide",
  "introduced": 1985,
  "operator": "Verisign",
  "restrictions": "None - open registration",
  "rdap_supported": true,
  "rdap_endpoint": "https://rdap.verisign.com/com/v1/",
  "idn_supported": true,
  "dnssec_supported": true,
  "pricing": {
    "registration_usd": 12,
    "renewal_usd": 12,
    "transfer_usd": 12,
    "currency": "USD",
    "source": "market_average"
  },
  "popularity": {
    "rank": 1,
    "tier": "top10",
    "use_cases": [
      "business",
      "personal",
      "startup",
      "enterprise",
      "tech",
      "e-commerce",
      "blog",
      "portfolio"
    ]
  },
  "trust": {
    "score": 100,
    "tier": "premium",
    "notes": "Most trusted TLD globally"
  },
  "meta": {
    "served_by": "pop=MAD country=ES"
  }
}

Codici di stato HTTP

  • 200 OK
  • 401 Non autorizzato
  • 402 Pagamento richiesto
  • 404 Non trovato
  • 429 Troppe richieste

Risorse di riferimento