Developer Reference

TLD Intelligence

DomScan API: Get detailed information about TLDs including pricing, restrictions, trust scores, and recommended use cases.

TLD Intelligence

Get detailed information about TLDs including pricing, restrictions, trust scores, and recommended use cases.

GET /v1/tlds

Query Parameters

Parameter	Type	Description
type optional	string Allowed values `gtldcctldnew-gtldidn`	Filter by type: gTLD, ccTLD, newTLD, idn
trust_tier optional	string Allowed values `premiumstandardeconomysuspicious`	Filter by trust: premium, standard, economy
use_case optional	string	Get TLDs for a use case (e.g., "startup", "tech")

Response Fields

Field	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

Example Response

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

GET /v1/tlds/:tld

Example Response

{
                "tld": "io",
                "type": "ccTLD",
                "name": "British Indian Ocean Territory",
                "description": "Popular with tech startups and SaaS companies",
                "introduced": 1997,
                "restrictions": "None - open registration",
                "rdap_supported": true,
                "pricing": {
                "registration_usd": 40,
                "renewal_usd": 40
                },
                "popularity": { "rank": 5, "tier": "top10", "use_cases": ["startup", "tech", "saas"] },
                "trust": { "score": 85, "tier": "premium" }
                }

Response Fields

Field	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