API-Dokumentation

Domain-Preise

Gibt alle verfügbaren TLDs und deren Registrierungspreise zurück. Optional kann über den tld-Abfrageparameter nach einer einzelnen TLD gefiltert werden, oder verwende domain, um eine bestimmte Domain auf Verfügbarkeit und Premium-Preise zu prüfen. Preise werden standardmäßig als Bruttopreise in EUR zurückgegeben; verwende currency und display zur Anpassung.

Anfrage

GET /api/v1/domains/pricing
GET /api/v1/domains/pricing?tld=com
GET /api/v1/domains/pricing?domain=example.com
GET /api/v1/domains/pricing?currency=USD&display=net

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL

Abfrageparameter

Parameter Erforderlich Beschreibung
tld Nein Nach einer bestimmten TLD filtern (z.B. com, de, io)
domain Nein Vollständiger Domainname zur Prüfung auf Verfügbarkeit und Premium-Gebühr (z.B. example.com)
currency Nein Preiswährung: EUR (Standard) oder USD
display Nein Preisanzeige: gross (Standard, Brutto) oder net (Netto, ohne MwSt.)

Antwort (Liste)

{
  "data": [
    { "tld": "com", "price": 0.00 },
    { "tld": "de", "price": 0.00 },
    { "tld": "io", "price": 0.00 }
  ],
  "currency": "EUR",
  "display": "gross",
  "count": 3
}

Antwort (Einzelne TLD)

Wenn der tld-Parameter angegeben wird:

{
  "data": {
    "tld": "com",
    "price": 0.00
  },
  "currency": "EUR",
  "display": "gross"
}

Gibt 404 zurück, wenn die TLD nicht verfügbar ist.

Antwort (Domain-Prüfung)

Wenn der domain-Parameter angegeben wird, werden zusätzlich Verfügbarkeit und Premium-Status geprüft:

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

Bei Premium-Domains werden premium und premiumFee mitgeliefert:

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

Antwortfelder

Feld Typ Beschreibung
tld string Top-Level-Domain (z.B. com, de, io)
price number Standard-Registrierungspreis pro Jahr
domain string Vollständiger Domainname (nur bei Domain-Prüfung)
available boolean Ob die Domain zur Registrierung verfügbar ist (nur bei Domain-Prüfung)
premium boolean Ob es sich um eine Premium-Domain mit erhöhtem Preis handelt (nur bei Domain-Prüfung, vorhanden wenn zutreffend)
premiumFee number Premium-Registrierungsgebühr pro Jahr (nur bei Domain-Prüfung, vorhanden bei Premium-Domains)
currency string Währungscode (EUR oder USD)
display string Anzeigemodus (gross oder net)
count number Gesamtanzahl der verfügbaren TLDs (nur bei Liste)

Beispiel

# Alle TLDs auflisten
curl https://hosting.site.quest/api/v1/domains/pricing \
  -H "Authorization: Bearer sq_live_a94ecfca096d..."

# Einzelne TLD abfragen
curl "https://hosting.site.quest/api/v1/domains/pricing?tld=com" \
  -H "Authorization: Bearer sq_live_a94ecfca096d..."

# Bestimmte Domain prüfen (Verfügbarkeit + Premium)
curl "https://hosting.site.quest/api/v1/domains/pricing?domain=example.com" \
  -H "Authorization: Bearer sq_live_a94ecfca096d..."

# Nettopreise in USD abrufen
curl "https://hosting.site.quest/api/v1/domains/pricing?currency=USD&display=net" \
  -H "Authorization: Bearer sq_live_a94ecfca096d..."

MCP

Diese Daten sind auch über das MCP-Tool get_domain_pricing verfügbar.