# Specialhotels.nl

> Nederlandstalig boekingsplatform voor bijzondere, romantische en kleinschalige
> hotels in Nederland en België. ~45 actieve, curated hotels (geen lange-staart).
> Gericht op koppels die een bijzondere overnachting zoeken.

## Wat je hier kunt doen
- Hotels zoeken op datum, regio of thema (romantisch, jacuzzi, privé sauna, bijzonder)
- Beschikbaarheid en prijzen checken per hotel (tot 12 maanden vooruit)
- Direct boeken via de website (betaling via Mollie iDEAL/Bancontact/creditcard)
- Cadeaubonnen kopen en inwisselen bij een boeking
- Reviews lezen van eerdere gasten per hotel
- Hotels kunnen zich gratis aanmelden om opgenomen te worden

## Sitemap
Alle indexeerbare pagina's: https://www.specialhotels.nl/sitemap.xml

## Hotels zoeken
GET /api/hotels/zoek?q=<term>&aankomst=YYYY-MM-DD&nachten=1

Parameters:
- q: zoekterm (naam, plaats, provincie, thema — minimaal 2 tekens)
- aankomst: datum in YYYY-MM-DD (optioneel, filtert op beschikbaarheid)
- nachten: aantal nachten (standaard 1)
- limit: max resultaten (standaard 20, max 100)
- offset: paginering

Response: { total, limit, offset, results: [ { id, naam, plaats, provincienaam, vanaf, cijfer, pretty, foto, opaanvraag } ] }

## Hotel detail
GET /api/hotels/:id

Response: { id, naam, plaats, straat, postcode, telefoon, website, email,
  omschrijving, ligging, faciliteiten, foto, lat, lon,
  cijfer, beoordelingen, vanaf, pretty,
  ai_titel_seo, ai_beschrijving_kort, ai_beschrijving_lang, ai_beschrijving_en,
  ai_usps (array), ai_gegenereerd_op }

Notities:
- pretty is de slug voor de hotelpagina en boeking: /hotels/:pretty
- ai_beschrijving_lang is de uitgebreide beschrijving (150-200 woorden, Nederlands)
- ai_beschrijving_en is de Engelse vertaling
- ai_usps is een array van 3-5 onderscheidende kenmerken
  voorbeeld: ["Privé jacuzzi op de kamer", "Romantisch landgoed", "Sauna en zwembad"]
- foto-URL: https://www.specialhotels.nl/foto/960x540/:fotoId.jpg

## Beschikbaarheid per datum
GET /api/hotels/:id/beschikbaarheid?aankomst=YYYY-MM-DD&nachten=1

Response: array van { datum, slots: [ { kamer, rate, prijs, voorraad, minimumstay, maximumstay, checkin, checkout, personen } ] }

## Beschikbare kamers (voor boeking)
GET /api/hotels/:id/opties?datum=YYYY-MM-DD&nachten=1

Response: array van beschikbare kamers met totaalprijs, kamernaam, rate-details.
Gebruik dit endpoint om een specifieke kamer + rate te kiezen voor het starten van een boeking.

## Kalender (12 maanden vooruit)
GET /api/hotels/:id/kalender

Response: object met datums als sleutel: { "YYYY-MM-DD": { prijs, kamer, rate } }
Toont de goedkoopste beschikbare optie per dag, paginatie per 3 maanden in de UI.

## Boeken
Boeking starten via de website: /hotels/:hotelSlug
Directe boekings-URL: /boeking/:hotelSlug?datum=YYYY-MM-DD&nachten=1&kamer=:kamerId&rate=:rateId
Betaling via Mollie (iDEAL, Bancontact, creditcard, Wero).
Sommige hotels werken op aanvraag (opaanvraag=1) — gast vult formulier in, hotel
bevestigt binnen 24u, daarna ontvangt gast een betaallink.

## Foto's
GET /api/hotels/:id/fotos — alle foto's van een hotel
Foto-URL patroon: /foto/WxH/:fotoId.jpg — beschikbare formaten: 320x180, 640x360,
960x540, 1280x720, 1920x1080. Ook .webp (kleinere bestanden, modernere clients).

## Arrangementen
GET /api/hotels/:id/arrangementen — speciale arrangementen (diner, wellness, etc.)

## Thema's
/thema/:slug — hotels gegroepeerd op thema. Voorbeelden:
romantische-hotels, prive-jacuzzi, prive-sauna, hotels-met-bubbelbad,
bijzonder-overnachten, liefdes-arrangementen, wellness-hotels, kasteelhotels,
boutique-hotels, bed-and-breakfast, gastronomische-hotels.

## Provincies
/provincie/:naam — hotels per provincie. Nederland: groningen, friesland, drenthe,
overijssel, gelderland, utrecht, noord-holland, zuid-holland, zeeland,
noord-brabant, limburg, flevoland. België: vlaanderen, wallonie. Plus luxemburg.

## Cadeaubonnen
Bestellen: https://www.specialhotels.nl/cadeaubon (€25-€2.500, betaling via Mollie,
PDF per mail). Inwisselbaar bij elke boeking — geheel of gedeeltelijk. Bonnummer
8 cijfers; bon vervalt nooit zolang specialhotels.nl actief is.

## Voor hotels — aanmelden
Hotels kunnen zich gratis aanmelden via https://www.specialhotels.nl/aanmelden.
Geen contract of abonnement vooraf. De aanmelder krijgt direct een magic-link naar
het hotelportaal (/hotel). Op de achtergrond verrijkt AI het profiel uit de
hotelwebsite (omschrijving, USPs, foto's). Specialhotels-redactie controleert en
zet het hotel live; commissie wordt per hotel onderhandeld (geen vaste %).

## Reviews
Reviews per hotel zijn zichtbaar op /hotels/:slug (laatste 5+ gastopmerkingen,
gemiddelde score per dimensie). Reviews komen uit een enquête die de gast na het
verblijf invult; alleen geverifieerde gasten kunnen reviewen.

## Stijl en doelgroep
- Curated, niet uitputtend — kwaliteit boven kwantiteit (~45 hotels, niet duizenden)
- Doelgroep: koppels die een bijzondere overnachting zoeken (geen budget-hotels,
  geen zakelijke reizigers, geen lange-verblijf-appartementen)
- Schrijfstijl: warm, natuurlijk Nederlands, je-vorm, geen superlatieven
- Commerciële relatie met hotels: commissiemodel per boeking (geen advertenties,
  geen betaalde plaatsing)