Referência da API

API de Inteligência de TLD

Obtenha inteligência detalhada sobre um TLD incluindo preços, restrições, suporte de registador e estatísticas de utilização. Use esta referência para escolher uma operação e integrar seu contrato de resposta documentado.

Ver página do produto

Operações

GET /v1/tlds Ver referência da API

GET /v1/tlds/:tld Ver referência da API

GET `/v1/tlds`

Operação: getTlds Créditos e autenticação: Grátis Autenticação opcional

GET /v1/tlds

Parâmetros de Consulta

Parâmetro	Tipo	obrigatório
type	string Valores permitidos `gtldcctldnew-gtldidn`	opcional
trust_tier	string Valores permitidos `premiumstandardeconomysuspicious`	opcional
use_case	string	opcional

Campos de Resposta

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

Pedido de Exemplo

curl "https://domscan.net/v1/tlds?type=example.com&trust_tier=example.com&use_case=startup"

Resposta de Exemplo

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

GET `/v1/tlds/:tld`

Operação: getTldDetail Créditos e autenticação: 1 Autenticação obrigatória

GET /v1/tlds/:tld

Parâmetros de Consulta

Parâmetro	Tipo	obrigatório
tld	string	obrigatório

Campos de Resposta

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

Pedido de Exemplo

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/tlds/com"

Resposta de Exemplo

{
  "tld": "com",
  "type": "gTLD",
  "name": "string",
  "description": "198.51.100.10",
  "introduced": 1,
  "operator": "string",
  "country": "string",
  "restrictions": "string",
  "rdap_supported": true,
  "rdap_endpoint": "string",
  "idn_supported": true,
  "dnssec_supported": true,
  "pricing": {
    "registration_usd": 1,
    "renewal_usd": 1,
    "transfer_usd": 1,
    "currency": "USD",
    "source": "estimate"
  },
  "popularity": {
    "rank": 1,
    "tier": "top10",
    "use_cases": [
      "string"
    ]
  },
  "trust": {
    "score": 1,
    "tier": "premium",
    "notes": "string"
  },
  "meta": {}
}

Recursos de referência

OpenAPI 3.0 Postman MCP