# Destination Bassin d'Arcachon

> Site touristique de la destination « Destination Bassin d'Arcachon » : fiches (hébergements, restaurants, activités, agenda, balades, infos pratiques) et moteur de recherche de disponibilités par dates. Tourism site with a date-based availability search.

## Moteur de recherche de disponibilités (hébergements)

Certaines pages de rubrique (hébergements) contiennent un **moteur de recherche par dates** : on choisit une date d'arrivée et de départ (et le nombre de voyageurs), et la page ne garde que les hébergements réellement disponibles sur la période, avec le prix du séjour et un lien de réservation.

**Pour un agent IA : n'interrogez pas la page HTML pour les disponibilités.** Les résultats de la page sont calculés par JavaScript ; sans navigateur, la page n'affiche pas de liste filtrée. Utilisez l'API JSON ci-dessous, qui renvoie les mêmes résultats sans JavaScript.

### API (recommandée)

`GET https://destination-bassindarcachon.com/api/availability.php`

| Paramètre | Requis | Description |
|---|---|---|
| `checkin` | oui | Date d'arrivée `YYYY-MM-DD` (pas dans le passé) |
| `checkout` | oui | Date de départ `YYYY-MM-DD` (après checkin, 60 nuits max) |
| `persons` | non | Nombre de voyageurs : ne garde que les hébergements pouvant les accueillir |
| `category` | non | Slug de rubrique (par défaut : toutes celles qui ont le moteur) |
| `commune` | non | Nom exact d'une commune |
| `poi` | non | Slug d'une fiche précise (dernier segment de son URL) — n'utiliser que pour vérifier UN établissement précis, à omettre pour une recherche générale |
| `lang` | non | fr, en, de, it, nl, es (défaut : fr) |
| `limit` | non | 1 à 100 (défaut 50) |

Exemple : [https://destination-bassindarcachon.com/api/availability.php?checkin=2026-11-23&checkout=2026-11-30&persons=2](https://destination-bassindarcachon.com/api/availability.php?checkin=2026-11-23&checkout=2026-11-30&persons=2)

Réponse : `{ ok, territory, checkin, checkout, total, returned, results: [ { name, city, category, stars, sleeps_max, total_price, currency, nights, page_url, booking_url } ] }`, triée par prix croissant. En cas d'erreur : `{ ok: false, error }` avec un code HTTP 4xx/5xx.

### Page web (pour un humain ou un navigateur)

Les mêmes dates se passent dans l'URL de la page de rubrique : `?checkin=YYYY-MM-DD&checkout=YYYY-MM-DD&persons=N`.

Exemple : [https://destination-bassindarcachon.com/campings?checkin=2026-11-23&checkout=2026-11-30&persons=2](https://destination-bassindarcachon.com/campings?checkin=2026-11-23&checkout=2026-11-30&persons=2)

### Pages avec moteur de recherche

- [Campings & Plein air](https://destination-bassindarcachon.com/campings)
- [Meublés & Gîtes ruraux](https://destination-bassindarcachon.com/meubles-gites)
- [Chambres d'hôtes & B&B](https://destination-bassindarcachon.com/chambres-hotes)
- [Hébergements insolites](https://destination-bassindarcachon.com/hebergements-insolites)

## Règles pour les agents

- Une fiche d'hébergement sans dates ne prouve **aucune disponibilité**. Pour « disponible du X au Y », appelez l'API avec `checkin`/`checkout`.
- **Recherche générale** (« trouve-moi un hébergement… ») : appelez l'API avec seulement `checkin`/`checkout` (+ `persons`/`category`/`commune` au besoin) — **n'ajoutez jamais `poi`** dans ce cas, il ne sert qu'au cas suivant.
- **Une seule fiche déjà identifiée** (URL du type `https://destination-bassindarcachon.com/{rubrique}/{slug-fiche}`) : pour connaître SON tarif/dispo, ajoutez `?checkin=YYYY-MM-DD&checkout=YYYY-MM-DD` à l'URL de la fiche (le prix du séjour est alors affiché dans la page), ou appelez l'API avec `poi={slug-fiche}` (dernier segment de l'URL, facultatif) en plus de `checkin`/`checkout` : `total` = 0 signifie non disponible sur ces dates.
- Les dates sont au format `YYYY-MM-DD` ; convertissez « du 26 septembre au 3 octobre 2026 » en `2026-09-26` / `2026-10-03`.
- `total_price` est le prix du séjour complet (`nights` nuits), pas le prix par nuit ; il peut être `null` (prix non communiqué) : ne l'inventez pas.
- La réservation se fait via `booking_url` (partenaire de réservation) ; ce site ne prend pas de paiement.
- Si `total` vaut 0, aucun hébergement n'est disponible sur ces dates : proposez d'autres dates plutôt que des fiches générales.
- Les réponses de disponibilité sont mises en cache 5 minutes. **Limite : 30 requêtes par minute et par IP** — au-delà, l'API répond `429` avec un en-tête `Retry-After`.

## Structure du site

- Langues : fr, en, de, it, nl, es ; la langue par défaut (`fr`) n'a pas de préfixe, les autres sont préfixées (`https://destination-bassindarcachon.com/en/…`).
- Accueil : `https://destination-bassindarcachon.com/` ; rubrique : `https://destination-bassindarcachon.com/{slug-rubrique}` ; fiche : `https://destination-bassindarcachon.com/{slug-rubrique}/{slug-fiche}`.
- [Plan du site](https://destination-bassindarcachon.com/sitemap.xml)
- [Version détaillée de ce document](https://destination-bassindarcachon.com/llms-full.txt)