Chaletiste Données API

openapi: 3.2.0
info:
  title: Chaletiste Données API
  version: 1.0.0
  summary: 'Comparateur français des chalets en bois en kit : données ouvertes, recherche, budget, urbanisme, devis.'
  description: 'API publique et gratuite de Chaletiste (https://chaletiste.fr). Lecture sans clé ; les fichiers /api/v1/*.json sont régénérés chaque nuit. Données sous licence CC BY 4.0, attribution « Chaletiste » avec lien. Les endpoints quote et price-alert transmettent des données personnelles : le consentement explicite de l''utilisateur humain est obligatoire (consent: true). Serveur MCP équivalent : https://chaletiste.fr/api/mcp. Documentation : https://chaletiste.fr/developpeurs/.'
  contact:
    name: Chaletiste
    email: bonjour@chaletiste.fr
    url: https://chaletiste.fr/developpeurs/
  license:
    name: CC BY 4.0 (données)
    identifier: CC-BY-4.0
servers:
- url: https://chaletiste.fr
security: []
tags:
- name: Données
  description: Fichiers JSON statiques, régénérés chaque nuit.
paths:
  /api/v1/index.json:
    get:
      operationId: getIndex
      tags:
      - Données
      summary: 'Point d''entrée : décrit tous les endpoints, les champs et la licence'
      responses:
        '200':
          description: Index
          content:
            application/json:
              schema:
                type: object
  /api/v1/products.json:
    get:
      operationId: listProducts
      tags:
      - Données
      summary: Tous les modèles, champs normalisés
      responses:
        '200':
          description: Catalogue complet
          content:
            application/json:
              schema:
                type: object
                properties:
                  count:
                    type: integer
                  products:
                    type: array
                    items:
                      $ref: '#/components/schemas/Product'
  /api/v1/products/{id}.json:
    get:
      operationId: getProductFile
      tags:
      - Données
      summary: Un modèle par son id
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
        example: blooma-selwyn-4-9-m
      responses:
        '200':
          description: Fiche
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Product'
              example:
                id: blooma-selwyn-4-9-m
                title: Blooma Selwyn 4,9 m²
                name: Selwyn 4,9 m²
                variant: 12 mm 4,87 m²
                brand:
                  id: blooma
                  name: Blooma
                  url: https://chaletiste.fr/marques/blooma/
                category:
                  id: abris-de-jardin-bois
                  name: Abris de jardin bois
                subcategory: abri
                habitable: false
                url: https://chaletiste.fr/chalets/blooma-selwyn-4-9-m/
                md_url: https://chaletiste.fr/chalets/blooma-selwyn-4-9-m.md
                api_url: https://chaletiste.fr/api/v1/products/blooma-selwyn-4-9-m.json
                summary: Le Selwyn 4,9 m² de Blooma coûte 480 € TTC (prix constaté chez Castorama le 27 septembre 2026), avec des parois de 12 mm (madriers emboîtés 12 mm), se monte en environ 1 jour (estimation, la marque ne communique pas de durée) et se livre sous 4 jours.
                price_eur: 480
                price_date: '2026-09-27'
                price_note: Prix TTC affiché le 2026-09-27, vendu et expédié par Castorama.
                price_per_m2_eur: 99
                retailer: Castorama
                buy_url: https://www.castorama.fr/abri-de-jardin-blooma-selwyn-en-bois-coloris-naturel-ep-12-mm-surface-exterieure-4-87-m-/3663602713258_CAFR.prd?utm_source=chaletiste&utm_medium=comparateur
                official_url: https://www.castorama.fr/abri-de-jardin-blooma-selwyn-en-bois-coloris-naturel-ep-12-mm-surface-exterieure-4-87-m-/3663602713258_CAFR.prd
                surface_m2: 4.87
                surface_note: Surface extérieure hors tout 4,87 m² ; surface intérieure 4 m² (fiche)
                footprint_m2: 4.87
                dimensions_m:
                  width: null
                  depth: null
                  height: null
                  note: Dimensions détaillées non publiées sur la fiche ; poids 160 kg
                wall_thickness_mm: 12
                wall_type: madriers emboîtés 12 mm
                wood: Bois d’origine Scandinavie
                treatment: traité en profondeur
                roof: À pignon, lames + feutre, toit 15 mm
                floor_included: true
                glazing: polycarbonate
                insulation: non isolé
                kit_level: kit panneaux à monter soi-même, plancher 38 mm inclus
                included: Panneaux 12 mm, plancher, double porte, 1 fenêtre polycarbonate, fixations
                foundations: null
                delivered_assembled: false
                assembly:
                  hours: 8.0
                  text: null
                  people: 2
                  estimated: true
                  basis: ratio médian de 1,60 h/m² observé sur 7 modèles comparables
                  source: https://www.castorama.fr/abri-de-jardin-blooma-selwyn-en-bois-coloris-naturel-ep-12-mm-surface-exterieure-4-87-m-/3663602713258_CAFR.prd
                delivery:
                  days_min: 4
                  days_max: null
                  text: Expédition annoncée sous 4 jours (donnée structurée de la fiche) ; date et frais exacts indiqués au panier
                  note: null
                  source: https://www.castorama.fr/services/livraison-domicile
                permit:
                  code: aucune
                  label: Aucune formalité
                  note: Emprise au sol de 5 m² ou moins et hauteur de 12 m ou moins, hors secteur protégé. En secteur protégé (abords d’un monument historique, site patrimonial remarquable), une déclaration préalable est exigée dès le premier mètre carré.
                warranty: Garantie fabricant 3 ans
                origin: null
                photo: https://chaletiste.fr/static/products/blooma-selwyn-4-9-m.webp
                photo_credit: Blooma
                similar_ids:
                - decor-et-jardin-abri-4-86-m
                - karibu-wandlitz-3-4-85-m
                - karibu-kandern-2-4-98-m
                - tuindeco-najette-5-m
                sources:
                - https://www.castorama.fr/abri-de-jardin-blooma-selwyn-en-bois-coloris-naturel-ep-12-mm-surface-exterieure-4-87-m-/3663602713258_CAFR.prd
                - https://www.castorama.fr/services/livraison-domicile
                verified_at: '2026-09-27'
        '404':
          description: Inconnu
  /api/v1/brands.json:
    get:
      operationId: listBrands
      tags:
      - Données
      summary: Toutes les marques
      responses:
        '200':
          description: Marques
          content:
            application/json:
              schema:
                type: object
  /api/v1/categories.json:
    get:
      operationId: listCategories
      tags:
      - Données
      summary: Catégories avec statistiques de prix et de surface
      responses:
        '200':
          description: Catégories
          content:
            application/json:
              schema:
                type: object
  /api/v1/guides.json:
    get:
      operationId: listGuides
      tags:
      - Données
      summary: 'Guides : titre, URL, phrase-réponse, FAQ, sources'
      responses:
        '200':
          description: Guides
          content:
            application/json:
              schema:
                type: object
components:
  schemas:
    Product:
      type: object
      required:
      - id
      - title
      - url
      - verified_at
      properties:
        id:
          type: string
          description: Identifiant stable du modèle (slug de l'URL de la fiche).
        title:
          type: string
          description: Marque + nom du modèle.
        name:
          type: string
          description: Nom du modèle tel que publié par la marque.
        variant:
          type:
          - string
          - 'null'
          description: Variante relevée (épaisseur, référence).
        brand:
          type: object
          description: '{id, name, url} de la marque.'
        category:
          type: object
          description: '{id, name} de la catégorie Chaletiste.'
        subcategory:
          type: string
          description: 'Sous-catégorie : abri, chalet-loisirs, chalet-bureau, pool-house, studio-jardin, chalet-habitable, maison-bois-kit, fuste-rondins, tiny-house, lodge.'
        habitable:
          type: boolean
          description: Conçu pour être habité.
        url:
          type: string
          description: Fiche HTML sur chaletiste.fr.
        md_url:
          type: string
          description: Version markdown de la fiche.
        api_url:
          type: string
          description: Cette fiche en JSON.
        summary:
          type: string
          description: Phrase-réponse citable résumant les quatre chiffres.
        price_eur:
          type:
          - number
          - 'null'
          description: Prix TTC constaté du kit, en euros.
        price_date:
          type:
          - string
          - 'null'
          format: date
          description: Date du relevé de prix.
        price_note:
          type:
          - string
          - 'null'
          description: Précision sur le prix (promotion, contenu).
        price_per_m2_eur:
          type:
          - number
          - 'null'
          description: Prix TTC divisé par la surface, arrondi à l'euro.
        retailer:
          type:
          - string
          - 'null'
          description: Marchand chez qui le prix a été relevé.
        buy_url:
          type:
          - string
          - 'null'
          description: Lien vers la page du marchand (peut être un lien d'affiliation).
        official_url:
          type:
          - string
          - 'null'
          description: Page officielle de la marque.
        surface_m2:
          type:
          - number
          - 'null'
          description: Surface annoncée en m².
        surface_note:
          type:
          - string
          - 'null'
          description: Ce que mesure la surface (intérieure, hors tout).
        footprint_m2:
          type:
          - number
          - 'null'
          description: Emprise au sol (largeur × profondeur), celle qui compte pour l'urbanisme.
        dimensions_m:
          type: object
          description: Dimensions en mètres.
          properties:
            width:
              type:
              - number
              - 'null'
            depth:
              type:
              - number
              - 'null'
            height:
              type:
              - number
              - 'null'
            note:
              type:
              - string
              - 'null'
        wall_thickness_mm:
          type:
          - number
          - 'null'
          description: Épaisseur des parois en millimètres.
        wall_type:
          type:
          - string
          - 'null'
          description: Type de paroi (madrier massif, double madrier, ossature isolée…).
        wood:
          type:
          - string
          - 'null'
          description: Essence de bois.
        treatment:
          type:
          - string
          - 'null'
          description: Traitement du bois.
        roof:
          type:
          - string
          - 'null'
          description: Toiture et couverture.
        floor_included:
          type:
          - boolean
          - 'null'
          description: Plancher inclus dans le kit.
        glazing:
          type:
          - string
          - 'null'
          description: Menuiseries et vitrage.
        insulation:
          type:
          - string
          - 'null'
          description: Isolation fournie.
        kit_level:
          type:
          - string
          - 'null'
          description: 'Niveau de kit : kit brut, kit madriers, hors d''eau hors d''air, livré monté, clé en main.'
        included:
          type:
          - string
          - 'null'
          description: Contenu du kit.
        foundations:
          type:
          - string
          - 'null'
          description: Fondations fournies ou recommandées.
        delivered_assembled:
          type: boolean
          description: Livré monté ou clé en main (pas de montage à prévoir).
        assembly:
          type: object
          description: '{hours, text, people, estimated, basis, source} : temps de montage. estimated = true : estimation Chaletiste (ratio h/m² de modèles comparables), jamais présentée comme donnée du fabricant.'
          properties:
            hours:
              type:
              - number
              - 'null'
            text:
              type:
              - string
              - 'null'
            people:
              type:
              - string
              - number
              - 'null'
            estimated:
              type: boolean
            basis:
              type:
              - string
              - 'null'
            source:
              type:
              - string
              - 'null'
        delivery:
          type: object
          properties:
            days_min:
              type:
              - number
              - 'null'
            days_max:
              type:
              - number
              - 'null'
            text:
              type:
              - string
              - 'null'
            note:
              type:
              - string
              - 'null'
            source:
              type:
              - string
              - 'null'
        permit:
          type:
          - object
          - 'null'
          properties:
            code:
              type: string
              enum:
              - aucune
              - dp
              - pc
            label:
              type: string
            note:
              type: string
        warranty:
          type:
          - string
          - 'null'
          description: Garantie annoncée.
        origin:
          type:
          - string
          - 'null'
          description: Pays de fabrication.
        photo:
          type:
          - string
          - 'null'
          description: URL de la photo (propriété de la marque, voir photo_credit).
        photo_credit:
          type:
          - string
          - 'null'
          description: Crédit de la photo.
        similar_ids:
          type: array
          items:
            type: string
          description: Identifiants de modèles similaires (même catégorie, surface proche).
        sources:
          type: array
          items:
            type: string
          description: URL des sources consultées.
        verified_at:
          type: string
          format: date
          description: Date de la dernière vérification de la fiche.
externalDocs:
  description: Guide développeurs et agents
  url: https://chaletiste.fr/developpeurs/