REST-API

Interfaces JSON pour développeurs : vérifier la disponibilité des domaines .ch, parcourir les domaines qui expirent, obtenir des suggestions.

🔑 Nouveau dès le 13.10.2026 : une clé API personnelle est nécessaire pour une utilisation régulière. La clé Starter est gratuite et demandée en une minute.

Forfaits

Starter

gratuit

250

Requêtes par jour

Pro

CHF 29

par mois

10'000

Requêtes par jour

ou CHF 290 en paiement annuel – 2 mois offerts

Business

CHF 99

par mois

50'000

Requêtes par jour

ou CHF 990 en paiement annuel – 2 mois offerts

plus vérification en masse

Sans clé: 20 vérifications, 200 recherches et 500 suggestions par jour et par IP – pour essayer.

Plus de volume ou une solution sur mesure ? Écrivez-nous : info@registriert.ch

Demander une clé

Starter : la clé arrive immédiatement par e-mail. Pro et Business : indiquez l’adresse de facturation, payez par carte ou TWINT (ou par facture QR) – la clé arrive automatiquement après le paiement.

Authentification

Envoyez votre clé dans l’en-tête X-API-Key (ou « Authorization: Bearer … », ou le paramètre key=). Chaque réponse contient X-RateLimit-Limit et X-RateLimit-Remaining.

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

GET /api/check.php

Vérification en direct d’un domaine .ch : statut, date d’expiration selon notre liste et alternatives.

Paramètres

domain — obligatoire, p. ex. hotel ou hotel.ch

Exemple

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

Réponse

{
  "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

Recherche dans le marché des domaines qui expirent, avec filtres (longueur, score, motifs). Sans clé : max. 60 résultats par page et 10 pages.

Paramètres

q — terme de recherche
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 — résultats par page (max. 120)

Exemple

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

Réponse

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

POST /api/bulk.php

Vérification en masse (forfait Business) : jusqu’à 100 domaines par appel, chacun compte comme 1 requête.

Paramètres

domains — liste JSON, max. 100 (avec ou sans .ch)

Exemple

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

Réponse

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

GET /api/suggest.php

Suggestions rapides pour la recherche (max. 8, Premium d’abord).

Paramètres

q — obligatoire, au moins 2 caractères

Exemple

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

Réponse

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

Codes d’erreur

401 invalid_key — Clé inconnue
403 key_disabled — Clé bloquée
429 daily_limit / key_required — Quota journalier atteint (remis à zéro à minuit, heure suisse)

Utilisation équitable

• Merci de mettre en cache les résultats de check – chaque requête déclenche une vérification en direct auprès du registre.
• Pas de requêtes massives en parallèle ; pour les grandes listes, utilisez la vérification en masse du forfait Business.
• Les données peuvent être utilisées dans vos applications, mais pas revendues comme liste.
• Des questions ? info@registriert.ch