L'emplacement vécu, appelable

La note de qualité de vie, les indicateurs et leurs millésimes des 34 894 communes de France, en HTTP. Sans clé, sans inscription, en lecture seule. Les données sont publiques et diffusées sous licence ODbL 1.0.

À lire avant de câbler. Le trajet n'est pas exposé par cette API, quel que soit son mode. Il dépend d'un profil (adresse de travail, jours sur site) que l'API ne prend pas. Pour mémoire, le site le calcule de deux façons : porte à porte en transports sur 22 éditions locales, et en voiture partout en France métropolitaine. Chaque réponse porte couverture.trajet: false pour que vous n'ayez pas à le découvrir en production.

Trois routes

Route	Ce qu'elle rend
`GET /api/v1/communes?q=`	recherche par nom → code INSEE
`GET /api/v1/commune/{insee}`	note, rang, indicateurs millésimés, drapeaux
`GET /api/v1/openapi.json`	le contrat OpenAPI 3.1

Essayer tout de suite

curl https://icioola.fr/api/v1/communes?q=quimper
curl https://icioola.fr/api/v1/commune/29232

Ce que rend une fiche

{
  "insee": "29232", "nom": "Quimper", "population": 64385,
  "note": { "sur_100": 68.7, "grade": "A",
            "rang_dans_sa_strate": 2, "communes_de_la_strate": 145,
            "exclut": ["prix"] },
  "indicateurs": {
    "price_apt_m2": { "valeur": 2109.8901098901097, "percentile": 84,
                      "millesime": "2023-2025",
                      "couverture_nationale": 0.1388, "confiance": "low" }
  },
  "couverture": { "trajet": false, "tier": "national" },
  "provenance": { "licence": "ODbL 1.0", "attribution": "Données Icioola — icioola.fr" }
}

Chaque indicateur porte son millésime et la couverture nationale de sa source. Un prix couvert à 13,8 % le dit ; une donnée absente est absente, jamais remplacée par un zéro.

Citer un chiffre

Chaque indicateur d'une commune a une page permanente qui porte sa valeur, sa source, son millésime, la méthode et ses limites, la taille de l'échantillon quand la source la publie, et une empreinte qui change si la valeur change. En HTML pour un lecteur, en JSON pour une machine :

https://icioola.fr/preuve/29232/price_apt_m2
https://icioola.fr/preuve/29232/price_apt_m2.json

L'adresse ne porte aucun numéro de build : elle reste valable quand les données sont reconstruites. Une donnée absente y est documentée comme absente — c'est l'un des usages prévus de la page, pas un cas d'erreur.

Serveur MCP

Pour que votre assistant appelle Icioola plutôt que de deviner. Transport JSON-RPC sur POST https://icioola.fr/api/mcp, deux outils : search_french_towns et get_french_town_profile.

{ "mcpServers": { "icioola": { "url": "https://icioola.fr/api/mcp" } } }

Attribution

La licence ODbL demande de citer la source de la base dérivée. Le libellé à reprendre :

Données Icioola — icioola.fr

Il voyage dans chaque réponse (provenance.attribution), avec sa variante HTML prête à coller. Nous ne revendiquons pas la propriété de chiffres publics : la mention porte sur leur retraitement.

Limites, usage, stabilité

Pas de clé en v1. La donnée est déjà publique et exportable depuis le site : une clé n'ajouterait que de la friction. Le débit est protégé côté serveur.
La route /v1/ est gelée : une évolution incompatible passera par /v2/.
Aucun calcul n'est refait par l'API : elle sert exactement ce que le site affiche. Un écart entre les deux serait un défaut, pas une nuance.
Un usage industriel, un besoin de trajet ou de garantie de service ? contact@icioola.fr.

Méthode de calcul de la note : /methode. Sources et licences : /donnees.