API-Dokumentation

Domain-Verfügbarkeit prüfen

Prüfe, ob eine Domain zur Registrierung verfügbar ist. Unterstützt die Prüfung einer einzelnen Domain oder eines Basisnamens über mehrere TLDs in einer Anfrage. Gibt Verfügbarkeitsstatus, Premium-Infos und Preise zurück.

Anfrage

POST /api/v1/domains/check

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL
Content-Type Ja application/json

Body-Parameter

Parameter Erforderlich Beschreibung
domain Ja Vollständiger Domainname (z.B. example.com) oder Basisname bei Verwendung von tlds (z.B. example)
tlds Nein Array von TLDs zur Prüfung (z.B. ["com", "de", "io"]). Wenn angegeben, wird domain als Basisname behandelt. Max. 20.
currency Nein Preiswährung: EUR (Standard) oder USD
display Nein Preisanzeige: gross (Standard, Brutto) oder net (Netto, ohne MwSt.)

Antwort (Einzelne Domain)

{
  "data": {
    "domain": "example.com",
    "tld": "com",
    "available": true,
    "price": 0.00
  },
  "currency": "EUR",
  "display": "gross"
}

Bei Premium-Domains werden premium und premiumFee mitgeliefert:

{
  "data": {
    "domain": "crypto.com",
    "tld": "com",
    "available": false,
    "premium": true,
    "premiumFee": 0.00,
    "price": 0.00
  },
  "currency": "EUR",
  "display": "gross"
}

Antwort (Multi-TLD)

Wenn tlds angegeben wird, werden Ergebnisse für alle angeforderten TLDs zurückgegeben:

{
  "data": [
    { "domain": "example.com", "tld": "com", "available": true, "price": 0.00 },
    { "domain": "example.de", "tld": "de", "available": true, "price": 0.00 },
    { "domain": "example.io", "tld": "io", "available": false, "price": 0.00 }
  ],
  "currency": "EUR",
  "display": "gross"
}

Antwortfelder

Feld Typ Beschreibung
domain string Vollständiger Domainname, der geprüft wurde
tld string Top-Level-Domain (z.B. com, de)
available boolean Ob die Domain zur Registrierung verfügbar ist
price number Standard-Registrierungspreis pro Jahr (vorhanden, wenn die TLD angeboten wird)
premium boolean Ob es sich um eine Premium-Domain handelt (vorhanden wenn zutreffend)
premiumFee number Premium-Registrierungsgebühr pro Jahr (vorhanden bei Premium-Domains)
currency string Währungscode (EUR oder USD)
display string Anzeigemodus (gross oder net)

Beispiel

# Einzelne Domain prüfen
curl -X POST https://hosting.site.quest/api/v1/domains/check \
  -H "Authorization: Bearer sq_live_a94ecfca096d..." \
  -H "Content-Type: application/json" \
  -d '{"domain": "example.com"}'

# Basisname über mehrere TLDs prüfen
curl -X POST https://hosting.site.quest/api/v1/domains/check \
  -H "Authorization: Bearer sq_live_a94ecfca096d..." \
  -H "Content-Type: application/json" \
  -d '{"domain": "example", "tlds": ["com", "de", "io", "net", "org"]}'

# Mit USD-Nettopreisen prüfen
curl -X POST https://hosting.site.quest/api/v1/domains/check \
  -H "Authorization: Bearer sq_live_a94ecfca096d..." \
  -H "Content-Type: application/json" \
  -d '{"domain": "example.com", "currency": "USD", "display": "net"}'

MCP

Diese Aktion ist auch über das check_domain MCP-Tool verfügbar.