sitemap.xml - Whois

25 Anfragen pro Minute

GET POST https://ciolvrawhois.de/request

Version1.1.0

FormatJSON

Limit pro IP-Adresse25 + 1 Min. Pause

AuthentifizierungKeine

Endpunkte

GETPOST/requestWhois-Daten zu einer Domain oder IP-Adresse.

GET/limitAktueller Limit-Stand. Zählt nicht als Anfrage.

GET/healthStatus des Dienstes.

GET/openapi.jsonOpenAPI-3.1-Spezifikation.

Parameter

query: Pflicht. Domain oder IP-Adresse (IPv4 oder IPv6) als String im JSON-Body.
parse: Optional, Boolean. Mit true kommen zusätzlich strukturierte Felder in data.parsed.

Anfrage und Antwort

Request

{
  "query": "domain.tld"
}

Response 200

{
  "response": "Successfully fetched WHOIS information",
  "state": "success",
  "data": {
    "query": "domain.tld",
    "type": "domain",
    "whois": "Domain: domain.tld\n..."
  }
}

Strukturierte Felder

Request

{
  "query": "domain.tld",
  "parse": true
}

Response 200

{
  "response": "Successfully fetched WHOIS information",
  "state": "success",
  "data": {
    "query": "domain.tld",
    "type": "domain",
    "whois": "Domain: domain.tld\n...",
    "parsed": {
      "registrar": "Musterregistrar GmbH",
      "organisation": null,
      "country": null,
      "created": "2020-01-01T00:00:00Z",
      "expires": "2027-01-01T00:00:00Z",
      "updated": "2026-01-01T00:00:00Z",
      "status": ["clientTransferProhibited"],
      "nameservers": ["ns1.domain.tld", "ns2.domain.tld"]
    }
  }
}

Beispiele

curl POST

curl -X POST https://ciolvrawhois.de/request \
  -H "Content-Type: application/json" \
  -d '{"query": "domain.tld"}'

curl GET

curl -X GET https://ciolvrawhois.de/request \
  -H "Content-Type: application/json" \
  -d '{"query": "domain.tld"}'

Weitere Endpunkte

GET /limit

{
  "response": "Current rate limit status",
  "state": "success",
  "data": {
    "limit": 25,
    "window": 60,
    "used": 3,
    "remaining": 22,
    "locked": false,
    "cooldown": 0
  }
}

GET /health

{
  "response": "Service is running",
  "state": "success",
  "data": {
    "version": "1.1.0",
    "time": "2026-01-01T12:00:00+00:00"
  }
}

Statuscodes

200: Erfolg, die Whois-Daten stehen in data.whois.
400: Ungültiger oder fehlender Wert für query oder parse.
404: Zu dieser Domain gibt es keine Whois-Daten.
405: Falsche HTTP-Methode. Erlaubt sind GET und POST.
429: Alle Anfragen verbraucht. Es gilt eine Wartezeit von einer Minute, siehe Retry-After.
502: Der Whois-Dienst ist vorübergehend nicht erreichbar.

Fehlerformat

Response 429

{
  "response": "Rate limit exceeded. Try again later.",
  "state": "error",
  "retry_after": 60
}

Antwort-Header

X-RateLimit-Limit: Erlaubte Anfragen am Stück.
X-RateLimit-Remaining: Verbleibende Anfragen. Verbrauchte Anfragen sind erst nach vollem Verbrauch und einer Minute Wartezeit wieder verfügbar.
Retry-After: Sekunden bis zur nächsten erlaubten Anfrage, nur bei Status 429.