REST-API

Interfacce JSON per sviluppatori: verificare la disponibilità dei domini .ch, cercare domini in scadenza, ottenere suggerimenti.

🔑 Novità dal 13.10.2026: per l’uso regolare serve una chiave API personale. La chiave Starter è gratuita e si richiede in un minuto.

Pacchetti

Starter

gratuito

250

Richieste al giorno

Pro

CHF 29

al mese

10'000

Richieste al giorno

oppure CHF 290 con pagamento annuale – 2 mesi in regalo

Business

CHF 99

al mese

50'000

Richieste al giorno

oppure CHF 990 con pagamento annuale – 2 mesi in regalo

più verifica in blocco

Senza chiave: 20 verifiche, 200 ricerche e 500 suggerimenti al giorno per IP – per provare.

Più volume o una soluzione su misura? Ci scriva: info@registriert.ch

Richiedere una chiave

Starter: la chiave arriva subito per e-mail. Pro e Business: indichi l’indirizzo di fatturazione e paghi con carta o TWINT (o con fattura QR) – la chiave arriva automaticamente dopo il pagamento.

Autenticazione

Invii la chiave nell’header X-API-Key (oppure «Authorization: Bearer …» o il parametro key=). Ogni risposta contiene X-RateLimit-Limit e X-RateLimit-Remaining.

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

GET /api/check.php

Verifica in tempo reale di un dominio .ch: stato, data di scadenza dalla nostra lista e alternative.

Parametri

domain — obbligatorio, p. es. hotel o hotel.ch

Esempio

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

Risposta

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

Ricerca nel mercato dei domini in scadenza con filtri (lunghezza, score, schemi). Senza chiave: max. 60 risultati per pagina e 10 pagine.

Parametri

q — termine di ricerca
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 — risultati per pagina (max. 120)

Esempio

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

Risposta

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

POST /api/bulk.php

Verifica in blocco (pacchetto Business): fino a 100 domini per chiamata, ognuno conta come 1 richiesta.

Parametri

domains — lista JSON, max. 100 (con o senza .ch)

Esempio

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

Risposta

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

GET /api/suggest.php

Suggerimenti rapidi per la ricerca (max. 8, Premium prima).

Parametri

q — obbligatorio, almeno 2 caratteri

Esempio

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

Risposta

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

Codici di errore

401 invalid_key — Chiave sconosciuta
403 key_disabled — Chiave bloccata
429 daily_limit / key_required — Quota giornaliera raggiunta (azzerata a mezzanotte, ora svizzera)

Uso corretto

• Memorizzi localmente i risultati di check – ogni richiesta avvia una verifica in tempo reale presso il registro.
• Niente richieste massive in parallelo; per liste grandi c’è la verifica in blocco del pacchetto Business.
• I dati possono essere usati nelle sue applicazioni, ma non rivenduti come lista.
• Domande? info@registriert.ch