API-Referenz

API für TLD-Intelligence

Erhalten Sie detaillierte Intelligence über eine TLD, einschließlich Preisgestaltung, Einschränkungen, Registrar-Unterstützung und Nutzungsstatistiken. Nutzen Sie diese Referenz, um eine Operation auszuwählen und den dokumentierten Response-Vertrag zu integrieren.

Operationen

GET /v1/tlds API-Referenz ansehen
GET /v1/tlds/:tld API-Referenz ansehen

GET /v1/tlds

Operation: getTlds Credits und Authentifizierung: Kostenlos Authentifizierung optional
GET /v1/tlds

Abfrageparameter

Parameter Typ erforderlich
type string
Zulässige Werte gtldcctldnew-gtldidn
optional
trust_tier string
Zulässige Werte premiumstandardeconomysuspicious
optional
use_case string optional

Antwort-Felder

Feld Typ
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

Beispielanfrage

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

Beispielantwort

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

Operation: getTldDetail Credits und Authentifizierung: 1 Authentifizierung erforderlich
GET /v1/tlds/:tld

Abfrageparameter

Parameter Typ erforderlich
tld string erforderlich

Antwort-Felder

Feld Typ
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

Beispielanfrage

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

Beispielantwort

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

Referenzressourcen