REST-API

JSON-Schnittstellen für Entwickler: Verfügbarkeit von .ch-Domains prüfen, ablaufende Domains durchsuchen, Vorschläge abrufen.

🔑 Neu ab 13.10.2026: Für regelmässige Nutzung braucht es einen persönlichen API-Schlüssel. Der Starter-Schlüssel ist kostenlos und in einer Minute beantragt.

Pakete

Starter

kostenlos

250

Abfragen pro Tag

Pro

CHF 29

pro Monat

10'000

Abfragen pro Tag

oder CHF 290 bei Jahreszahlung – 2 Monate geschenkt

Business

CHF 99

pro Monat

50'000

Abfragen pro Tag

oder CHF 990 bei Jahreszahlung – 2 Monate geschenkt

plus Massenprüfung

Ohne Schlüssel: 20 Prüfungen, 200 Suchen und 500 Vorschläge pro Tag und IP – zum Ausprobieren.

Mehr Volumen oder eine eigene Lösung? Schreiben Sie uns: info@registriert.ch

Schlüssel beantragen

Starter: Der Schlüssel kommt sofort per E-Mail. Pro und Business: Rechnungsadresse angeben, bezahlen mit Karte oder TWINT (oder per QR-Rechnung) – der Schlüssel kommt nach Zahlungseingang automatisch.

Authentifizierung

Schicken Sie Ihren Schlüssel im Header X-API-Key mit (alternativ „Authorization: Bearer …“ oder Parameter key=). Jede Antwort enthält X-RateLimit-Limit und X-RateLimit-Remaining.

curl -H 'X-API-Key: reg_…' 'https://registriert.ch/api/check.php?domain=hotel'

GET /api/check.php

Live-Verfügbarkeitsprüfung für eine .ch-Domain: Status, Ablaufdatum aus unserer Liste und Alternativen.

Parameter

domain — Pflicht, z. B. hotel oder hotel.ch

Beispiel

curl -H 'X-API-Key: reg_…' 'https://registriert.ch/api/check.php?domain=hotel'

Antwort

{
  "ok": true,
  "name": "hotel.ch",
  "available": false,
  "in_db": false,
  "premium": false,
  "expiry_date": null,
  "whois": { "registrar": "..." },
  "alternatives": [
    { "name": "hotel-ch.ch", "source": "marktplatz_frei" }
  ]
}

GET /api/search.php

Suche im Marktplatz der ablaufenden Domains mit Filtern (Länge, Score, Wortmuster). Ohne Schlüssel: max. 60 Treffer pro Seite und 10 Seiten.

Parameter

q — Suchbegriff
len — 3, 4, 5, 6, 7, 8+
timing — today, 48h, past, all
starts, contains, ends
score_min, score_max — 0–100
no_numbers, no_hyphens — 0 / 1
offset
limit — Treffer pro Seite (max. 120)

Beispiel

curl -H 'X-API-Key: reg_…' 'https://registriert.ch/api/search.php?q=hotel&len=5&score_min=40'

Antwort

{
  "total": 234,
  "offset": 0,
  "limit": 60,
  "results": [
    { "name": "hotel.ch", "expiry_date": "2026-11-04", "score": 72, "auction": null }
  ]
}

POST /api/bulk.php

Massenprüfung (Paket Business): bis 100 Domains pro Aufruf, jede zählt als 1 Abfrage.

Parameter

domains — JSON-Liste, max. 100 (mit oder ohne .ch)

Beispiel

curl -X POST -H 'X-API-Key: reg_…' -H 'Content-Type: application/json' \
  -d '{"domains":["hotel","beispiel.ch"]}' https://registriert.ch/api/bulk.php

Antwort

{
  "ok": true,
  "count": 2,
  "results": [
    { "name": "hotel.ch", "available": false },
    { "name": "beispiel.ch", "available": false }
  ]
}

GET /api/suggest.php

Schnelle Vorschläge für die Domain-Suche (max. 8, Premium zuerst).

Parameter

q — Pflicht, mindestens 2 Zeichen

Beispiel

curl -H 'X-API-Key: reg_…' 'https://registriert.ch/api/suggest.php?q=hot'

Antwort

{
  "ok": true,
  "items": [
    { "name": "hotelblick.ch", "type": "premium" },
    { "name": "hotelluzern.ch", "expiry_date": "2026-11-01", "type": "expiring" }
  ]
}

Fehlercodes

401 invalid_key — Schlüssel unbekannt
403 key_disabled — Schlüssel gesperrt
429 daily_limit / key_required — Tageskontingent erreicht (zurückgesetzt um Mitternacht, Schweizer Zeit)

Faire Nutzung

• Ergebnisse von check bitte lokal zwischenspeichern – jede Abfrage löst eine Live-Prüfung bei der Registrierungsstelle aus.
• Keine parallelen Massenabfragen; für grosse Listen gibt es die Massenprüfung im Business-Paket.
• Die Daten dürfen in eigenen Anwendungen genutzt, aber nicht als eigene Liste weiterverkauft werden.
• Fragen? info@registriert.ch