Aller au contenu
Chateaupedia

API

Branchez-vous sur les données

Le dataset complet, un endpoint par château, en licence ouverte. La clé est gratuite et sert seulement à savoir qui consomme quoi.

Photo : Château de Saumur Carsten Steger, CC BY-SA 4.0

Cinq points d’entrée

GET /api/dataset.json
Le jeu complet, paginé (limit, offset). Champs imbriqués : horaires par saison, tarifs par catégorie.
GET /api/dataset.csv
Une ligne par château, colonnes à plat. Encodé UTF-8 avec BOM pour s’ouvrir correctement dans Excel.
GET /api/chateau/{slug}.json
Une fiche. Chaque champ pratique porte sa source et sa date de vérification.
GET /fr/chateau/{slug}.md
La même fiche en Markdown, sans navigation ni script. Suffixez .md à n’importe quelle URL de fiche, dans les trois langues. Sans clé.
GET /llms.txt
Description du corpus, licence, manière de nous citer et points d’entrée. Sans clé.

Authentification

La clé passe dans l’en-tête Authorization. Un paramètre ?key= est accepté pour les outils qui ne savent pas envoyer d’en-tête, mais il finit dans les logs des proxys : préférez l’en-tête.

curl -H "Authorization: Bearer ck_live_…" \
  https://chateaupedia.com/api/dataset.json?limit=100

Limites

Licence

ODbL 1.0. Vous pouvez réutiliser, modifier et redistribuer, y compris commercialement, à condition de citer Chateaupedia et de partager les mêmes libertés sur les données dérivées.

Demander une clé

L’attribution est manuelle pour l’instant : nous lisons chaque demande. Comptez 48 heures ouvrées.

Deux lignes suffisent. Ça nous sert à vous prévenir avant un changement de schéma, pas à filtrer les demandes.