---
title: "Palmarès de communes par indicateur"
method: GET
path: "/communes/palmares"
---

# Palmarès de communes par indicateur

`GET /communes/palmares`

## Request

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

Communes classées sur un indicateur publié par Pillr, avec les filtres et les tris des pages de classement du site : rendement locatif, cashflow positif, zones A et A bis, prix bas, prix élevés, peu de passoires, score Pillr, communes sous le prix attendu de leur département, meilleur rendement, ou les deux à la fois. En France, dans un département ou dans une région. Chaque ligne porte son rang, sa valeur, sa population et ses ventes ; les seuils de fiabilité appliqués sont rendus en clair. Liste paginée. Coût : 1 crédit par élément rendu.

## Query parameters

- `indicateur` 'rendement-locatif' | 'cashflow-positif' | 'pinel-a' | 'prix-bas' | 'prix-eleve' | 'peu-de-passoires' | 'score-pillr' | 'sous-evaluees' | 'meilleur-rendement' | 'sous-evaluees-et-rendement', required: L'indicateur du classement.
- `departement` string: Code du département (01 à 95, 2A, 2B, 971 à 976).
- `region` string: Région : code INSEE, nom court ou nom.
- `population_min` number: Population minimale ; par défaut celle des pages de classement du site, plus basse en maille géographique et pour les classements d'étude. Le seuil appliqué est rendu dans filtres_appliques.
- `transactions_min` number: Ventes minimales.
- `limite` integer: Nombre d'éléments par page (50 au plus).
- `curseur` string: Curseur opaque rendu par la page précédente (curseur_suivant), à repasser tel quel.

## Response `200`

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

- object
  - `indicateur` 'rendement-locatif' | 'cashflow-positif' | 'pinel-a' | 'prix-bas' | 'prix-eleve' | 'peu-de-passoires' | 'score-pillr' | 'sous-evaluees' | 'meilleur-rendement' | 'sous-evaluees-et-rendement', required
  - `libelle` string, required
  - `methode` string, required
  - `maille` object, required
    - `niveau` 'france' | 'departement' | 'region', required
    - `code` string, nullable, required
    - `nom` string, nullable, required
  - `filtres_appliques` string[], required: Les seuils de fiabilité appliqués, en clair.
  - `donnees` object[], required
    - `rang` integer, required
    - `insee` string, required
    - `commune` string, nullable, required
    - `code_postal` string, nullable, required
    - `departement` string, nullable, required
    - `region` string, nullable, required
    - `population` integer, nullable, required
    - `transactions` integer, nullable, required
    - `prix_m2_appartement` number, nullable, required
    - `prix_m2_maison` number, nullable, required
    - `loyer_m2_predit` number, nullable, required
    - `rendement_brut_appartement_pct` number, nullable, required
    - `rendement_brut_maison_pct` number, nullable, required
    - `prix_residuel_pct` number, nullable, required
    - `evolution_3_ans_pct` number, nullable, required
    - `passoires_dpe_fg_pct` number, nullable, required
    - `zone_abc` string, nullable, required
    - `score_attractivite` number, nullable, required
    - `valeur_indicateur` 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.
  - `donnees_du` string, nullable, required
  - `curseur_suivant` string, nullable, required: Curseur de la page suivante, à repasser dans curseur ; null sur la dernière page.
  - `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 ; Curseur invalide
- `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)