L'emplacement vécu, appelable

La note de qualité de vie, les indicateurs et leurs millésimes des 34 917 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 porte à porte en transports n'est pas exposé par cette API : le site le calcule sur 22 éditions locales, à partir d'une adresse de travail. Le classement (/api/v1/classement) accepte un lieu de travail hors de ces éditions et filtre alors sur le trajet en voiture ; dans une édition, il ne classe pas et renvoie le lien du site, qui classe en transports. Les fiches portent couverture.trajet: false pour que vous n'ayez pas à le découvrir en production.

Quatre 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/classement?priorities=`	le classement du site selon des priorités et des contraintes, et le lien qui le rouvre
`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
curl "https://icioola.fr/api/v1/classement?priorities=safety,schools&max_price_per_m2=3000&limit=5"

Ce que rend une fiche

{
  "insee": "29232", "nom": "Quimper", "population": 64385,
  "note": { "sur_100": 61.3, "grade": "A",
            "rang_dans_sa_strate": 11, "communes_de_la_strate": 156,
            "exclut": ["prix"] },
  "indicateurs": {
    "price_apt_m2": { "valeur": 2109.8901098901097, "percentile": 74,
                      "millesime": "2023-2025",
                      "couverture_nationale": 0.1394, "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, trois outils : search_french_towns, get_french_town_profile et rank_towns — ce dernier classe les communes par le moteur du site et rend le lien qui rouvre le classement sur icioola.fr.

{ "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.