L'API est publique, en lecture seule (sauf mention contraire) et ne nécessite pas de clé. Toutes les réponses sont au format JSON, sauf /api/v1/stats_geojson (GeoJSON) et /api/v1/stats/by_insee/{insee}/places.csv (CSV).

Zones géographiques

GET /api/v1/zone/ville/{insee}

Statistiques complètes d'une commune (code INSEE) : complétion, lieux, historique.

GET /api/v1/zone/epci/{codeEpci}

Agrégat des statistiques d'un EPCI (intercommunalité).

GET /api/v1/zone/department/{code}

Agrégat des statistiques d'un département (ex. 91, 2A).

GET /api/v1/zone/region/{code}

Agrégat des statistiques d'une région.

GET /api/v1/zone/country

Agrégat national (France entière).

Villes suivies

GET /api/v1/stats_geojson

Toutes les villes suivies, au format GeoJSON (une Feature point par ville, avec complétion et compteurs en propriétés). Utile pour afficher une carte.

GET /api/v1/stats/{insee}

Fiche résumée d'une ville suivie (complétion, population, SIREN, codes postaux…).

GET /api/v1/stats/{insee}/places

Liste des lieux (commerces/équipements) d'une ville. Pagination optionnelle via ?page= et ?perPage= (max 100).

GET /api/v1/stats/by_insee/{insee}/places.csv

Export CSV des lieux d'une ville.

GET /api/v1/stats/export

Export global des statistiques de toutes les villes suivies.

GET /api/v1/stats/{insee}/followup

Historique de suivi (évolution de la complétion et des compteurs dans le temps) pour une ville.

Autres

GET /api/v1/panoramax/nearby

Photos Panoramax à proximité d'un point (?lat=&lon=).

GET /api/v1/mangrove/reviews

Avis Mangrove Reviews connus pour un lieu.

GET /api/v1/cartes/reviews

Avis cartes.app connus pour un lieu.

Le code source de l'application est disponible sur la page copyright OpenStreetMap. Pour toute question sur l'API, contactez-nous.