---
title: "Analyse rédigée d'une commune"
method: GET
path: "/communes/{insee}/analyse-ia"
---

# Analyse rédigée d'une commune

`GET /communes/{insee}/analyse-ia`

## Request

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

Analyse rédigée de la commune, déjà générée et stockée par Pillr : note de synthèse sur 100 et sous-notes, points forts, signaux d'alerte avec leur atténuation, recommandations. Servie comme sur les pages communes : les affirmations que le modèle ne pouvait pas sourcer (transport, délinquance, risques, équipements) sont remplacées par les mesures du jour, rendues à côté, et les textes sont réécrits pour la lecture. Aucun modèle n'est appelé. 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).

## 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.
  - `note_synthese` number, nullable, required: Note de synthèse sur 100, rédigée par le modèle à partir des données mesurées.
  - `lecture_note` string, nullable, required: Comment lire la note.
  - `sous_notes` object, required
    - `liquidite` number, nullable, required
    - `demande_locative` number, nullable, required
    - `croissance` number, nullable, required
    - `tourisme` number, nullable, required
    - `risque` number, nullable, required
  - `points_forts` object[], required
    - `titre` string, required
    - `raison` string, nullable, required
  - `signaux_alerte` object[], required
    - `titre` string, required
    - `raison` string, nullable, required
    - `attenuation` string, nullable, required
  - `recommandations` object[], required
    - `titre` string, required
    - `action` string, nullable, required
  - `mesures` object, required: Ce que les données mesurées disent de la commune, substitué aux affirmations que le modèle ne pouvait pas sourcer.
    - `equipements` string, nullable, required
    - `acces` string, nullable, required
    - `securite` string, nullable, required
    - `risques` string, required
  - `version` string, nullable, required
  - `modele` string, nullable, required
  - `genere_le` string, 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.
  - `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)