---
title: "Prix au m² d'une commune : barème, série, évolutions"
method: GET
path: "/communes/{insee}/prix"
---

# Prix au m² d'une commune : barème, série, évolutions

`GET /communes/{insee}/prix`

## Request

- Base URL: `https://pillr.fr/api/v1`
- URL: `https://pillr.fr/api/v1/communes/{insee}/prix`
- Auth: HTTP bearer

Prix de référence au m² d'une commune par type de bien, avec toute sa qualité : provenance (mesuré ou estimé), ventes et ventes récentes, communes voisines et ventes du bassin, poids local, dominance, demi-bande d'incertitude, prix local brut. Rien n'est masqué : un prix sur peu de ventes est servi avec son nombre et son drapeau. S'y ajoutent la série annuelle (prix, transactions, minimum, maximum, basse confiance), les évolutions sur 1, 3 et 5 ans avec leur confiance et celle du département, l'indice annuel du département et la ligne indexée (barème multiplié par l'indice). Paris, Lyon et Marseille se lisent par arrondissement. Coût : 2 crédits par appel réussi.

## Path parameters

- `insee` string, required: Code INSEE de la commune ou de l'arrondissement (5 caractères, 2A ou 2B pour la Corse).

## Query parameters

- `type` 'appartement' | 'maison': Ne garder qu'un type de bien (appartement ou maison) ; les deux par défaut.

## Response `200`

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

- object
  - `insee` string, required: Code INSEE demandé.
  - `commune` string, nullable, required: Nom de la commune ou de l'arrondissement.
  - `bareme` object[], required
    - `type` 'appartement' | 'maison', required
    - `millesime` string, nullable, required
    - `prix_m2` number, nullable, required
    - `label` 'mesure' | 'estime', nullable, required: mesure : mesuré sur les ventes DVF de la commune ; estime : estimé par le barème sur trop peu de ventes pour une mesure, à lire avec le nombre de ventes ; null : non étiquetée.
    - `n_ventes` integer, nullable, required
    - `n_ventes_recentes` integer, nullable, required
    - `nb_voisins` integer, nullable, required
    - `n_ventes_bassin` integer, nullable, required
    - `poids_local` number, nullable, required
    - `dominance` number, nullable, required
    - `demi_bande_pct` number, nullable, required
    - `prix_m2_local` number, nullable, required
    - `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.
  - `serie` object[], required
    - `annee` integer, required
    - `prix_m2_appartement` number, nullable, required
    - `prix_m2_maison` number, nullable, required
    - `prix_m2_global` number, nullable, required
    - `transactions` integer, nullable, required
    - `transactions_appartement` integer, nullable, required
    - `transactions_maison` integer, nullable, required
    - `min_appartement` number, nullable, required
    - `max_appartement` number, nullable, required
    - `min_maison` number, nullable, required
    - `max_maison` number, nullable, required
    - `basse_confiance_appartement` boolean, nullable, required
    - `basse_confiance_maison` boolean, nullable, required
  - `evolution` object, nullable, required
    - `appartement` object, required
      - `un_an` number, nullable, required
      - `trois_ans` number, nullable, required
      - `cinq_ans` number, nullable, required
    - `maison` object, required
      - `un_an` number, nullable, required
      - `trois_ans` number, nullable, required
      - `cinq_ans` number, nullable, required
    - `global` object, required
      - `un_an` number, nullable, required
      - `trois_ans` number, nullable, required
      - `cinq_ans` number, nullable, required
    - `tendance_5_ans` string, nullable, required
    - `confiance` string, nullable, required
    - `derniere_annee` integer, nullable, required
    - `transactions_annee_recente` integer, nullable, required
    - `transactions_3_ans` integer, nullable, required
    - `departement` object, required
      - `un_an` number, nullable, required
      - `trois_ans` number, nullable, required
    - `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.
  - `ligne_indexee` object[], required: Trajectoire du prix de référence : barème multiplié par l'indice annuel du département, millésime par millésime.
    - `annee` integer, required
    - `prix_m2_appartement` number, nullable, required
    - `prix_m2_maison` number, nullable, required
  - `indice_departement` object[], required
    - `departement` string, required
    - `type` 'appartement' | 'maison', required
    - `annee` integer, required
    - `coef` number, nullable, required
    - `n_ventes` integer, nullable, required
  - `donnees_du` string, nullable, 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 ; Donnée momentanément 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)