25 Anfragen pro Minute
GET
POST
https://ciolvrawhois.de/request
Version1.1.0
FormatJSON
Limit25 + 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.Parameter
- query
- Pflicht. Domain oder IP-Adresse (IPv4 oder IPv6) als String im JSON-Body.
- parse
- Optional, Boolean. Mit
truekommen zusätzlich strukturierte Felder indata.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
queryoderparse. - 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.