Référence API

API Intelligence TLD

Obtenez une intelligence détaillée sur un TLD incluant les prix, les restrictions, le support des registraires et les statistiques d'utilisation. Utilisez cette référence pour choisir une opération et intégrer son contrat de réponse documenté.

Voir la page du produit

Opérations

GET /v1/tlds Voir la référence API

GET /v1/tlds/:tld Voir la référence API

GET `/v1/tlds`

Opération: getTlds Crédits et authentification: Gratuit Authentification facultative

GET /v1/tlds

Paramètres de Requête

Paramètre	Type	requis
type	string Valeurs autorisées `gtldcctldnew-gtldidn`	optionnel
trust_tier	string Valeurs autorisées `premiumstandardeconomysuspicious`	optionnel
use_case	string	optionnel

Champs de Réponse

Champ	Type
`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

Exemple de Requête

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

Exemple de Réponse

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

Opération: getTldDetail Crédits et authentification: 1 Authentification requise

GET /v1/tlds/:tld

Paramètres de Requête

Paramètre	Type	requis
tld	string	requis

Champs de Réponse

Champ	Type
`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

Exemple de Requête

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

Exemple de Réponse

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

Ressources de référence

OpenAPI 3.0 Postman MCP