---
title: "Marché d'une commune"
method: GET
path: "/communes/{insee}"
---

# Marché d'une commune

`GET /communes/{insee}`

## Request

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

Marché immobilier d'une commune ou d'un arrondissement, par code INSEE : prix de référence au m² des appartements et des maisons avec leur provenance (mesuré sur les ventes DVF ou estimé) et le nombre de ventes, loyer d'annonce au m² et loyers par type de logement (Carte des loyers), rendement brut théorique, évolution des prix sur 1 et 3 ans, zone ABC, et le marché en vente du dernier mois calculé (annonces en ligne, nouvelles annonces, prix affiché médian, part des baisses, délai médian en ligne). Mêmes chiffres que les pages communes de pillr.fr. Paris, Lyon et Marseille sont servies en agrégat de leurs arrondissements. Coût : 1 crédit 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).

## Response `200`

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

- object
  - `insee` string, required
  - `commune` string, required
  - `code_postal` string, nullable, required
  - `departement` string, nullable, required
  - `region` string, nullable, required
  - `population` number, nullable, required
  - `agrege` boolean, required: Vrai pour Paris, Lyon et Marseille : agrégat de leurs arrondissements, pondéré par les ventes.
  - `prix_m2` object, required
    - `appartement` number, nullable, required
    - `maison` number, nullable, required
    - `provenance_appartement` '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.
    - `provenance_maison` '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.
    - `ventes_appartement` number, nullable, required
    - `ventes_maison` number, nullable, required
    - `millesime` string, nullable, required
    - `arrondissements` object, nullable, required
      - `appartement` object, required
        - `total` integer, required
        - `avec_prix` integer, required
        - `mesures` integer, required
        - `estimes` integer, required
        - `ventes` integer, nullable, required
      - `maison` object, required
        - `total` integer, required
        - `avec_prix` integer, required
        - `mesures` integer, required
        - `estimes` integer, required
        - `ventes` integer, nullable, required
  - `loyer_m2` object, required
    - `mensuel` number, nullable, required
    - `min_95` number, nullable, required
    - `max_95` number, nullable, required
    - `source` string, nullable, required
    - `millesime` number, nullable, required
  - `loyers_par_typologie` object[], required
    - `typologie` 'T1' | 'T2' | 'T3' | 'T4' | 'T5' | 'maison', required
    - `surface_m2` number, required
    - `segment` 'appartement' | 'appartement_t1_t2' | 'appartement_t3plus' | 'maison', required
    - `repli` boolean, required
    - `loyer_m2` number, required
    - `loyer_mensuel` number, required
    - `fourchette_mensuelle` object, nullable, required
      - `min` number, required
      - `max` number, required
  - `rendement_brut_pct` object, required
    - `appartement` number, nullable, required
    - `maison` number, nullable, required
  - `evolution_prix_pct` object, required
    - `un_an` number, nullable, required
    - `trois_ans` number, nullable, required
    - `confiance` string, nullable, required
  - `zone_abc` string, nullable, required
  - `marche_en_vente` object, required
    - `statut` 'ok' | 'perime' | 'absent' | 'indisponible', required: ok : chiffres servis ; perime : calcul trop ancien ; absent : aucune annonce de la commune le dernier mois ; indisponible : source momentanément injoignable.
    - `mois` string, nullable, required: Mois des chiffres, AAAA-MM.
    - `calcule_le` string, nullable, required
    - `annonces_en_ligne` number, nullable, required
    - `nouvelles_annonces` number, nullable, required
    - `annonces_retirees` number, nullable, required
    - `delai_median_jours` number, nullable, required
    - `part_baissees_pct` number, nullable, required
    - `prix_affiche_m2_median` number, nullable, required
    - `variation_annonces_en_ligne_pct` number, nullable, required
    - `variation_nouvelles_annonces_pct` number, nullable, required
    - `variation_prix_affiche_m2_pct` number, nullable, required
    - `volumes_comparables` boolean, nullable, required: Faux quand l'un des deux mois comparés précède la stabilisation de la collecte : aucune variation de volume n'est alors calculée.
    - `mois_mise_a_jour_collecte` boolean, nullable, required: Vrai quand le mois trahit un changement de la collecte plutôt que du marché : seuls les nouvelles annonces et le prix affiché sont servis.
  - `donnees_du` string, nullable, required: Date de reconstruction des données de la commune.
  - `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)