---
title: "Baromètre"
method: GET
path: "/barometre/{edition}"
---

# Baromètre

`GET /barometre/{edition}`

## Request

- Base URL: `https://pillr.fr/api/v1`
- URL: `https://pillr.fr/api/v1/barometre/{edition}`
- Auth: HTTP bearer

L'édition figée du baromètre de Pillr pour la France, un département ou une commune : chaque mesure du registre (prix de référence, ventes, loyer, rendement, annonces, baisses de prix, biens à rénover, budget travaux, écart au prix de référence, part des DPE F et G, résidences secondaires, vacance, revenu), avec son effectif, son intervalle quand il existe, et son seuil de publication. Rien n'est masqué : une valeur sous le seuil de publication du site est servie avec publiee = faux et son motif. edition vaut AAAA-MM ou courante. Édition ou territoire inconnus : 404, rien n'est débité. Coût : 1 crédit par appel réussi.

## Path parameters

- `edition` string, required: Édition (AAAA-MM), ou courante.

## Query parameters

- `echelle` 'france' | 'departement' | 'commune': france (défaut), departement ou commune.
- `cle` string: Code du département (echelle departement) ou code INSEE (echelle commune).

## Response `200`

Réponse servie et débitée (sauf réponse identique déjà servie dans les 24 h).

- object
  - `edition` string, required
  - `donnees_au` string, required: Date d'arrêt des données de l'édition (AAAA-MM-JJ).
  - `methode` string, required: Version de la méthode.
  - `revision` string, required
  - `echelle` 'france' | 'departement' | 'commune', required
  - `cle` string, required: FR, code du département ou code INSEE.
  - `nom` string, required
  - `mesures` object[], required
    - `cle` string, required: Identifiant de la mesure dans le registre (fg, baisse, prixA...).
    - `libelle` string, required
    - `nature` string, required: annonce, vente, diag, recens ou loyer.
    - `unite` string, required
    - `valeur` number, nullable, required: La valeur de l'édition, servie même sous le seuil de publication du site ; null si elle n'existe pas à cette échelle.
    - `n` integer, nullable, required: Effectif derrière la valeur, quand la mesure en a un.
    - `seuil_publication` integer, nullable, required: Effectif minimal pour que le site publie la valeur.
    - `seuil_classement` integer, nullable, required
    - `publiee` boolean, required: Vrai si le site publie la valeur (effectif suffisant, prix de référence assez précis).
    - `motif` 'non_disponible' | 'sous_seuil', nullable, required: Pourquoi le site ne publie pas la valeur ; null si elle est publiée.
    - `intervalle` object, nullable, required: Intervalle de confiance à 95 %, quand la mesure en a un.
      - `bas` number, required
      - `haut` number, required
    - `date` string, required: Date de la mesure dans cette édition.
    - `qualite` object, required: Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
      - `n` integer, nullable, required: Nombre d'observations derrière la valeur ; null si sans objet.
      - `provenance` 'mesure' | 'estime', nullable, required: mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
      - `incertitude` object, nullable, required: Incertitude de la valeur : fourchette et demi-largeur.
        - `demi_largeur_pct` number, nullable, required: Demi-largeur de la fourchette, en % de la valeur.
        - `bas` number, nullable, required
        - `haut` number, nullable, required
      - `drapeaux` string[], required: Ce qui doit faire lire la valeur avec prudence ; vide si rien.
      - `methode` string, nullable, required: Méthode de calcul ou de rattachement, en clair.
      - `donnees_du` string, nullable, required: Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
      - `source` string, required: Source publique ou moteur Pillr, en clair.
  - `registre` object[], required: Le registre des mesures du baromètre, seuils de publication compris.
    - `cle` string, required
    - `libelle` string, required
    - `nature` string, required
    - `unite` string, required
    - `echelles` string[], required
    - `source` string, required
    - `calcul` string, required
    - `seuil` string, required
    - `limite` string, required
    - `seuil_publication` integer, nullable, required
    - `seuil_classement` integer, nullable, required
  - `calcule_le` string, required
  - `credits` object, required: Crédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).
    - `debites` integer, required
    - `restants` integer, nullable, required

## Other responses

- `304`: Non modifiée depuis l'ETag fourni : rien n'est débité.
- `400`: Paramètres invalides
- `401`: Clé d'API absente
- `402`: Crédits insuffisants ; Carte requise ; Plafond mensuel de dépense atteint
- `403`: Portée insuffisante
- `404`: Ressource absente : rien n'est débité
- `429`: Trop de requêtes par minute
- `500`: Erreur interne
- `503`: API indisponible

---

[API](https://skmtc.dev/pillr/apis/api-pillr.md) · [All operations](https://skmtc.dev/pillr/apis/api-pillr/llms.txt) · [OpenAPI document](https://skmtc.dev/pillr/apis/api-pillr/revisions/218b2866bd6c?raw)