Aller au contenu

Documentation

Risques et équipements

Risques naturels et technologiques, équipements, accès, délinquance et cadre de vie d'une commune. 2 opérations servies.

Risques naturels et technologiques

Essayer en direct
GET/api/v1/communes/{insee}/risques

Risques d'une commune : inondation, remontée de nappe, séisme, mouvement de terrain, argiles, radon, feu de forêt, site industriel, nucléaire, pollution des sols, rupture de barrage et risque minier, avec leur niveau et un score composite là où Géorisques est relevé en base, et les risques recensés par l'API publique Géorisques en direct ailleurs ; potentiel radon de l'IRSN pour toutes les communes ; arrêtés de catastrophe naturelle depuis 1982. Chaque bloc dit sa source. Ne remplace pas l'état des risques d'une adresse, obligatoire avant un achat.

Coût
2 crédits par appel réussi
Accès
À l'usage ou avec l'abonnement Data
Portée
territoire
Outil MCP
risques_commune
Bac à sable
Oui, sans débit, sur un jeu figé
Cache serveur
24 h
Délai maximal
15 s

Paramètres

  • inseetexteobligatoire

    Code INSEE de la commune ou de l'arrondissement (5 caractères, 2A ou 2B pour la Corse).

Exemple d'appel

curl https://pillr.fr/api/v1/communes/76540/risques \
  -H "Authorization: Bearer $PILLR_CLE"

Cette entrée est dans le bac à sable : une clé pk_test_ obtient la réponse, sans débit.

Réponse du bac à sable

{
  "insee": "76540",
  "commune": "ROUEN",
  "risques": {
    "source": "base",
    "par_risque": {
      "inondation": {
        "present": true,
        "niveau": 1
      },
      "remontee_nappe": {
        "present": true,
        "niveau": 1
      },
      "seisme": {
        "present": true,
        "niveau": 1
      },
      "mouvement_terrain": {
        "present": true,
        "niveau": 1
      },
      "argiles": {
        "present": true,
        "niveau": 2
      },
      "radon": {
        "present": true,
        "niveau": 1
      },
      "feu_foret": {
        "present": false,
        "niveau": 0
      },
      "icpe": {
        "present": true,
        "niveau": 1
      },
      "nucleaire": {
        "present": false,
        "niveau": 0
      },
      "pollution_sols": {
        "present": true,
        "niveau": 1
      },
      "rupture_barrage": {
        "present": false,
        "niveau": 0
      },
      "minier": {
        "present": false,
        "niveau": 0
      }
    },
    "libelles": [
      "Inondation",
      "Remontée de nappe",
      "Sismicité (niveau 1)",
      "Mouvement de terrain",
      "Retrait-gonflement des argiles",
      "Radon (niveau 1)",
      "Site industriel (ICPE)",
      "Pollution des sols"
    ],
    "score_risque_composite": 71,
    "qualite": {
      "n": null,
      "provenance": "mesure",
      "incertitude": null,
      "drapeaux": [],
      "methode": "relevé Géorisques de la commune en base, niveaux de 0 à 3",
      "donnees_du": "2026-11-11",
      "source": "Géorisques, relevé par commune en base (georisques_par_commune)"
    }
  },
  "radon": {
    "classe": 1,
    "qualite": {
      "n": null,
      "provenance": "mesure",
      "incertitude": null,
      "drapeaux": [],
      "methode": "classe de potentiel radon de la commune, 1 à 3",
      "donnees_du": null,
      "source": "IRSN, potentiel radon des communes"
    }
  },
  "catnat": {
    "arretes": [
      {
        "code": "INTE1810998A",
        "nature": "Inondations et/ou Coulées de Boue",
        "debut": "2018-01-22",
        "fin": "2018-02-04",
        "arrete_publie_le": "2018-04-17"
      },
      {
        "code": "INTE0600133A",
        "nature": "Inondations et/ou Coulées de Boue",
        "debut": "2005-07-03",
        "fin": "2005-07-04",
        "arrete_publie_le": "2006-03-02"
      },
      {
        "code": "INTE0500053A",
        "nature": "Inondations et/ou Coulées de Boue",
        "debut": "2004-07-22",
        "fin": "2004-07-22",
        "arrete_publie_le": "2005-04-15"
      },
      {
        "code": "INTE9900627A",
        "nature": "Mouvement de Terrain",
        "debut": "1999-12-25",
        "fin": "1999-12-29",
        "arrete_publie_le": "1999-12-29"
      },
      {
        "code": "INTE9900627A",
        "nature": "Chocs Mécaniques liés à l'action des Vagues",
        "debut": "1999-12-25",
        "fin": "1999-12-29",
        "arrete_publie_le": "1999-12-29"
      },
      {
        "code": "INTE9900627A",
        "nature": "Inondations et/ou Coulées de Boue",
        "debut": "1999-12-25",
        "fin": "1999-12-29",
        "arrete_publie_le": "1999-12-29"
      },
      {
        "code": "INTE0000045A",
        "nature": "Inondations et/ou Coulées de Boue",
        "debut": "1999-12-24",
        "fin": "1999-12-24",
        "arrete_publie_le": "2000-02-07"
      },
      {
        "code": "INTE9800067A",
        "nature": "Inondations et/ou Coulées de Boue",
        "debut": "1997-08-07",
        "fin": "1997-08-07",
        "arrete_publie_le": "1998-03-12"
      },
      {
        "code": "INTE9700281A",
        "nature": "Inondations et/ou Coulées de Boue",
        "debut": "1997-06-16",
        "fin": "1997-06-17",
        "arrete_publie_le": "1997-07-01"
      },
      {
        "code": "INTE9500103A",
        "nature": "Inondations et/ou Coulées de Boue",
        "debut": "1995-01-17",
        "fin": "1995-02-05",
        "arrete_publie_le": "1995-02-21"
      },
      {
        "code": "INTE9400582A",
        "nature": "Inondations et/ou Coulées de Boue",
        "debut": "1994-07-27",
        "fin": "1994-07-29",
        "arrete_publie_le": "1994-12-06"
      },
      {
        "code": "INTE9400269A",
        "nature": "Inondations et/ou Coulées de Boue",
        "debut": "1993-12-27",
        "fin": "1994-01-20",
        "arrete_publie_le": "1994-06-06"
      },
      {
        "code": "INTE9000289A",
        "nature": "Inondations et/ou Coulées de Boue",
        "debut": "1990-02-26",
        "fin": "1990-03-01",
        "arrete_publie_le": "1990-07-24"
      },
      {
        "code": "ECOZ8800025A",
        "nature": "Inondations et/ou Coulées de Boue",
        "debut": "1988-02-15",
        "fin": "1988-02-21",
        "arrete_publie_le": "1988-06-10"
      },
      {
        "code": "INTE8700362A",
        "nature": "Inondations et/ou Coulées de Boue",
        "debut": "1987-09-01",
        "fin": "1987-09-01",
        "arrete_publie_le": "1987-11-03"
      },
      {
        "code": "NOR19850111",
        "nature": "Mouvement de Terrain",
        "debut": "1984-11-22",
        "fin": "1984-11-25",
        "arrete_publie_le": "1985-01-11"
      },
      {
        "code": "NOR19850111",
        "nature": "Inondations et/ou Coulées de Boue",
        "debut": "1984-11-22",
        "fin": "1984-11-25",
        "arrete_publie_le": "1985-01-11"
      }
    ],
    "qualite": {
      "n": 17,
      "provenance": "mesure",
      "incertitude": null,
      "drapeaux": [],
      "methode": "arrêtés de la commune, un par code officiel et par nature",
      "donnees_du": "2026-11-22",
      "source": "Géorisques, API publique GASPAR (arrêtés de catastrophe naturelle depuis 1982)"
    }
  },
  "phrase": "Potentiel radon de catégorie 1 sur 3 (IRSN) ; inondation faible, argiles moyen, mouvements de terrain faible (Géorisques). Pour l'adresse précise, l'état des risques est obligatoire avant tout achat.",
  "limites": [
    "Risques de la commune, pas de l'adresse : l'état des risques de l'adresse (georisques.gouv.fr) reste obligatoire avant un achat.",
    "Hors des communes relevées en base, un risque non recensé par GASPAR est dit absent ; GASPAR recense les risques connus de l'État."
  ],
  "sources": [
    "IRSN pour le radon, Géorisques pour les autres risques quand la commune est relevée",
    "Géorisques, relevé par commune en base (georisques_par_commune)",
    "Géorisques, API publique GASPAR (arrêtés de catastrophe naturelle depuis 1982)",
    "IRSN, potentiel radon des communes"
  ],
  "credits": {
    "debites": 0,
    "restants": null
  }
}

Réponse réelle de l'API à cette entrée, obtenue avec le moteur du bac à sable, donnée du 11/11/2026.

Réponse

  • inseetexte
  • communetexte ou null
  • risquesobjet
    Afficher les 5 champs
    • sourcetexte

      base : relevé Géorisques en base ; georisques : risques recensés par l'API publique Géorisques, en direct ; indisponible : l'API n'a pas répondu.

      Valeurs : base, georisques, indisponible

    • par_risqueobjet
      Afficher les 12 champs
      • inondationobjet
        Afficher les 2 champs
        • presentbooléen ou null

          Vrai : risque relevé ou recensé ; faux : ni relevé ni recensé ; null : inconnu (source indisponible).

        • niveauentier ou null

          Niveau relevé en base (0 absent, 1 faible, 2 moyen, 3 fort ; sismicité 1 à 5), ou zone de sismicité recensée ; null sans niveau.

      • remontee_nappeobjet
        Afficher les 2 champs
        • presentbooléen ou null

          Vrai : risque relevé ou recensé ; faux : ni relevé ni recensé ; null : inconnu (source indisponible).

        • niveauentier ou null

          Niveau relevé en base (0 absent, 1 faible, 2 moyen, 3 fort ; sismicité 1 à 5), ou zone de sismicité recensée ; null sans niveau.

      • seismeobjet
        Afficher les 2 champs
        • presentbooléen ou null

          Vrai : risque relevé ou recensé ; faux : ni relevé ni recensé ; null : inconnu (source indisponible).

        • niveauentier ou null

          Niveau relevé en base (0 absent, 1 faible, 2 moyen, 3 fort ; sismicité 1 à 5), ou zone de sismicité recensée ; null sans niveau.

      • mouvement_terrainobjet
        Afficher les 2 champs
        • presentbooléen ou null

          Vrai : risque relevé ou recensé ; faux : ni relevé ni recensé ; null : inconnu (source indisponible).

        • niveauentier ou null

          Niveau relevé en base (0 absent, 1 faible, 2 moyen, 3 fort ; sismicité 1 à 5), ou zone de sismicité recensée ; null sans niveau.

      • argilesobjet
        Afficher les 2 champs
        • presentbooléen ou null

          Vrai : risque relevé ou recensé ; faux : ni relevé ni recensé ; null : inconnu (source indisponible).

        • niveauentier ou null

          Niveau relevé en base (0 absent, 1 faible, 2 moyen, 3 fort ; sismicité 1 à 5), ou zone de sismicité recensée ; null sans niveau.

      • radonobjet
        Afficher les 2 champs
        • presentbooléen ou null

          Vrai : risque relevé ou recensé ; faux : ni relevé ni recensé ; null : inconnu (source indisponible).

        • niveauentier ou null

          Niveau relevé en base (0 absent, 1 faible, 2 moyen, 3 fort ; sismicité 1 à 5), ou zone de sismicité recensée ; null sans niveau.

      • feu_foretobjet
        Afficher les 2 champs
        • presentbooléen ou null

          Vrai : risque relevé ou recensé ; faux : ni relevé ni recensé ; null : inconnu (source indisponible).

        • niveauentier ou null

          Niveau relevé en base (0 absent, 1 faible, 2 moyen, 3 fort ; sismicité 1 à 5), ou zone de sismicité recensée ; null sans niveau.

      • icpeobjet
        Afficher les 2 champs
        • presentbooléen ou null

          Vrai : risque relevé ou recensé ; faux : ni relevé ni recensé ; null : inconnu (source indisponible).

        • niveauentier ou null

          Niveau relevé en base (0 absent, 1 faible, 2 moyen, 3 fort ; sismicité 1 à 5), ou zone de sismicité recensée ; null sans niveau.

      • nucleaireobjet
        Afficher les 2 champs
        • presentbooléen ou null

          Vrai : risque relevé ou recensé ; faux : ni relevé ni recensé ; null : inconnu (source indisponible).

        • niveauentier ou null

          Niveau relevé en base (0 absent, 1 faible, 2 moyen, 3 fort ; sismicité 1 à 5), ou zone de sismicité recensée ; null sans niveau.

      • pollution_solsobjet
        Afficher les 2 champs
        • presentbooléen ou null

          Vrai : risque relevé ou recensé ; faux : ni relevé ni recensé ; null : inconnu (source indisponible).

        • niveauentier ou null

          Niveau relevé en base (0 absent, 1 faible, 2 moyen, 3 fort ; sismicité 1 à 5), ou zone de sismicité recensée ; null sans niveau.

      • rupture_barrageobjet
        Afficher les 2 champs
        • presentbooléen ou null

          Vrai : risque relevé ou recensé ; faux : ni relevé ni recensé ; null : inconnu (source indisponible).

        • niveauentier ou null

          Niveau relevé en base (0 absent, 1 faible, 2 moyen, 3 fort ; sismicité 1 à 5), ou zone de sismicité recensée ; null sans niveau.

      • minierobjet
        Afficher les 2 champs
        • presentbooléen ou null

          Vrai : risque relevé ou recensé ; faux : ni relevé ni recensé ; null : inconnu (source indisponible).

        • niveauentier ou null

          Niveau relevé en base (0 absent, 1 faible, 2 moyen, 3 fort ; sismicité 1 à 5), ou zone de sismicité recensée ; null sans niveau.

    • libellesliste de textes

      Les risques en clair, tels que la source les nomme.

    • score_risque_compositenombre ou null

      Score composite de la base, sur 100 ; null hors des communes relevées.

    • qualiteobjet

      Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.

      Afficher les 7 champs
      • nentier ou null

        Nombre d'observations derrière la valeur ; null si sans objet.

        0 au moins

      • provenancetexte ou null

        mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.

        Valeurs : mesure, estime

      • incertitudeobjet ou null

        Incertitude de la valeur : fourchette et demi-largeur.

        Afficher les 3 champs
        • demi_largeur_pctnombre ou null

          Demi-largeur de la fourchette, en % de la valeur.

        • basnombre ou null
        • hautnombre ou null
      • drapeauxliste de textes

        Ce qui doit faire lire la valeur avec prudence ; vide si rien.

        Valeurs : prix_atypique, surface_atypique, vente_en_bloc, doublon_probable, date_estimee, peu_d_observations, valeur_imputee, rattachement_incertain, donnee_ancienne

      • methodetexte ou null

        Méthode de calcul ou de rattachement, en clair.

      • donnees_dutexte ou null

        Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).

      • sourcetexte

        Source publique ou moteur Pillr, en clair.

  • radonobjet
    Afficher les 2 champs
    • classeentier ou null

      Potentiel radon de l'IRSN, 1 à 3 (3 : significatif).

    • qualiteobjet

      Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.

      Afficher les 7 champs
      • nentier ou null

        Nombre d'observations derrière la valeur ; null si sans objet.

        0 au moins

      • provenancetexte ou null

        mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.

        Valeurs : mesure, estime

      • incertitudeobjet ou null

        Incertitude de la valeur : fourchette et demi-largeur.

        Afficher les 3 champs
        • demi_largeur_pctnombre ou null

          Demi-largeur de la fourchette, en % de la valeur.

        • basnombre ou null
        • hautnombre ou null
      • drapeauxliste de textes

        Ce qui doit faire lire la valeur avec prudence ; vide si rien.

        Valeurs : prix_atypique, surface_atypique, vente_en_bloc, doublon_probable, date_estimee, peu_d_observations, valeur_imputee, rattachement_incertain, donnee_ancienne

      • methodetexte ou null

        Méthode de calcul ou de rattachement, en clair.

      • donnees_dutexte ou null

        Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).

      • sourcetexte

        Source publique ou moteur Pillr, en clair.

  • catnatobjet
    Afficher les 2 champs
    • arretesliste d'objets ou null

      Arrêtés de catastrophe naturelle de la commune depuis 1982, du plus récent au plus ancien ; null si l'API n'a pas répondu.

      Afficher les 5 champs
      • codetexte
      • naturetexte
      • debuttexte

        Début de l'évènement (AAAA-MM-JJ).

      • fintexte ou null
      • arrete_publie_letexte ou null

        Publication de l'arrêté au Journal officiel (AAAA-MM-JJ).

    • qualiteobjet

      Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.

      Afficher les 7 champs
      • nentier ou null

        Nombre d'observations derrière la valeur ; null si sans objet.

        0 au moins

      • provenancetexte ou null

        mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.

        Valeurs : mesure, estime

      • incertitudeobjet ou null

        Incertitude de la valeur : fourchette et demi-largeur.

        Afficher les 3 champs
        • demi_largeur_pctnombre ou null

          Demi-largeur de la fourchette, en % de la valeur.

        • basnombre ou null
        • hautnombre ou null
      • drapeauxliste de textes

        Ce qui doit faire lire la valeur avec prudence ; vide si rien.

        Valeurs : prix_atypique, surface_atypique, vente_en_bloc, doublon_probable, date_estimee, peu_d_observations, valeur_imputee, rattachement_incertain, donnee_ancienne

      • methodetexte ou null

        Méthode de calcul ou de rattachement, en clair.

      • donnees_dutexte ou null

        Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).

      • sourcetexte

        Source publique ou moteur Pillr, en clair.

  • phrasetexte
  • limitesliste de textes
  • sourcesliste de textes
  • creditsobjet

    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).

    Afficher les 2 champs
    • debitesentier

      0 au moins

    • restantsentier ou null

Erreurs possibles

  • 400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
  • 403hors_bac_a_sableUne clé pk_test_ demande une entrée hors du jeu figé de l'opération
Afficher les 11 erreurs communes à toute l'API

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs

Équipements, accès, délinquance et cadre de vie

Essayer en direct
GET/api/v1/communes/{insee}/mesures

Mesures d'une commune, chacune avec sa phrase et sa source, celles de l'analyse de zone de pillr.fr : équipements de la Base permanente des équipements (quinze comptes sur la commune entière et les essentiels absents), gare de voyageurs et aéroport les plus proches avec la distance, délinquance enregistrée par catégorie (faits et taux pour 1 000 habitants, comparés à la moyenne des communes publiées), potentiel radon et risques relevés, points d'intérêt à 500 m et score de marche à pied là où ils sont calculés.

Coût
2 crédits par appel réussi
Accès
À l'usage ou avec l'abonnement Data
Portée
territoire
Outil MCP
mesures_zone
Bac à sable
Oui, sans débit, sur un jeu figé
Cache serveur
24 h
Délai maximal
5 s

Paramètres

  • inseetexteobligatoire

    Code INSEE de la commune ou de l'arrondissement (5 caractères, 2A ou 2B pour la Corse).

Exemple d'appel

curl https://pillr.fr/api/v1/communes/76540/mesures \
  -H "Authorization: Bearer $PILLR_CLE"

Cette entrée est dans le bac à sable : une clé pk_test_ obtient la réponse, sans débit.

Réponse du bac à sable

{
  "insee": "76540",
  "commune": "ROUEN",
  "equipements": {
    "perimetre": "commune entière",
    "comptes": {
      "total": 22168,
      "services_particuliers": 6684,
      "commerces": 3303,
      "commerces_alimentaires": 333,
      "enseignement": 456,
      "ecoles": 60,
      "colleges": 14,
      "lycees": 13,
      "sante_social": 5058,
      "medecins_generalistes": 159,
      "pharmacies": 35,
      "transports": 201,
      "gares": 1,
      "sports_loisirs": 660,
      "tourisme": 264
    },
    "essentiels_absents": [],
    "phrase": "Dans la commune : 60 écoles, 27 collèges et lycées, 159 médecins généralistes, 35 pharmacies, 333 commerces alimentaires de proximité (INSEE, Base permanente des équipements 2024).",
    "qualite": {
      "n": null,
      "provenance": "mesure",
      "incertitude": null,
      "drapeaux": [],
      "methode": "équipements comptés sur la commune entière",
      "donnees_du": "2026-05-17",
      "source": "INSEE, Base permanente des équipements 2024"
    }
  },
  "acces": {
    "gare": {
      "nom": "Rouen Rive Droite",
      "categorie": "nationale",
      "km": 0.7
    },
    "aeroport": {
      "nom": "Deauville Normandie",
      "iata": "DOL",
      "km": 68.5
    },
    "phrase": "Gare la plus proche : Rouen Rive Droite, gare nationale, à 0,7 km ; aéroport à vols réguliers le plus proche : Deauville Normandie, à 69 km, à vol d'oiseau depuis le centre habité de la commune.",
    "qualite": {
      "n": null,
      "provenance": "mesure",
      "incertitude": null,
      "drapeaux": [],
      "methode": "distances à vol d'oiseau depuis le centre habité de la commune",
      "donnees_du": "2026-09-24",
      "source": "Gares de voyageurs SNCF Open Data (ODbL) et aéroports à vols réguliers (OurAirports), distances à vol d'oiseau depuis le centre habité de la commune"
    }
  },
  "delinquance": {
    "annee": 2024,
    "population": 117662,
    "categories": [
      {
        "cle": "cambriolages",
        "nom": "Cambriolages de logement",
        "nb": 325,
        "taux_pour_1000": 2.7621492070507045,
        "moyenne_pour_1000": 3.42
      },
      {
        "cle": "destructions",
        "nom": "Destructions et dégradations volontaires",
        "nb": 1423,
        "taux_pour_1000": 12.0939641,
        "moyenne_pour_1000": 8.54
      },
      {
        "cle": "trafic_stupef",
        "nom": "Trafic de stupéfiants",
        "nb": 83,
        "taux_pour_1000": 0.7054104,
        "moyenne_pour_1000": 0.97
      },
      {
        "cle": "usage_stupef",
        "nom": "Usage de stupéfiants",
        "nb": 1407,
        "taux_pour_1000": 11.9579813,
        "moyenne_pour_1000": 5.42
      },
      {
        "cle": "violences_hcfam",
        "nom": "Violences physiques hors cadre familial",
        "nb": 919,
        "taux_pour_1000": 7.8105081,
        "moyenne_pour_1000": 3.59
      },
      {
        "cle": "violences_intra",
        "nom": "Violences physiques dans le cadre familial",
        "nb": 572,
        "taux_pour_1000": 4.8613826,
        "moyenne_pour_1000": 3.86
      },
      {
        "cle": "violences_sex",
        "nom": "Violences sexuelles",
        "nb": 423,
        "taux_pour_1000": 3.5950434,
        "moyenne_pour_1000": 1.93
      },
      {
        "cle": "vols_armes",
        "nom": "Vols avec armes",
        "nb": 44,
        "taux_pour_1000": 0.3739525,
        "moyenne_pour_1000": 0.13
      },
      {
        "cle": "vols_acc_veh",
        "nom": "Vols d'accessoires sur véhicules",
        "nb": 158,
        "taux_pour_1000": 1.3428295,
        "moyenne_pour_1000": 1.59
      },
      {
        "cle": "vols_dans_veh",
        "nom": "Vols dans les véhicules",
        "nb": 2930,
        "taux_pour_1000": 24.9018375,
        "moyenne_pour_1000": 4.67
      },
      {
        "cle": "vols_vehicule",
        "nom": "Vols de véhicules",
        "nb": 366,
        "taux_pour_1000": 3.110605,
        "moyenne_pour_1000": 2.34
      },
      {
        "cle": "vols_sans_viol",
        "nom": "Vols sans violence contre des personnes",
        "nb": 2897,
        "taux_pour_1000": 24.6213731,
        "moyenne_pour_1000": 10.84
      },
      {
        "cle": "vols_viol_sans_arme",
        "nom": "Vols violents sans arme",
        "nb": 361,
        "taux_pour_1000": 3.0681103,
        "moyenne_pour_1000": 0.91
      }
    ],
    "phrase": "En 2024, pour 1 000 habitants : 2,8 cambriolages de logement (3,4 en moyenne), 7,8 violences physiques hors cadre familial (3,6 en moyenne), 24,6 vols sans violence contre des personnes (10,8 en moyenne), 12,1 destructions et dégradations volontaires (8,5 en moyenne). Moyenne des communes dont les chiffres sont publiés. Source : Ministère de l'Intérieur (SSMSI), délinquance enregistrée par la police et la gendarmerie.",
    "qualite": {
      "n": null,
      "provenance": "mesure",
      "incertitude": null,
      "drapeaux": [],
      "methode": "faits enregistrés par la police et la gendarmerie, taux pour 1 000 habitants (les cambriolages, publiés pour 1 000 logements, rapportés aux habitants) ; moyenne des communes publiées en 2024, calcul Pillr",
      "donnees_du": null,
      "source": "Ministère de l'Intérieur (SSMSI), délinquance enregistrée par la police et la gendarmerie"
    }
  },
  "risques": {
    "radon_classe": 1,
    "releve": {
      "inondation": "faible",
      "argiles": "moyen",
      "mouvement_terrain": "faible"
    },
    "phrase": "Potentiel radon de catégorie 1 sur 3 (IRSN) ; inondation faible, argiles moyen, mouvements de terrain faible (Géorisques). Pour l'adresse précise, l'état des risques est obligatoire avant tout achat.",
    "qualite": {
      "n": null,
      "provenance": "mesure",
      "incertitude": null,
      "drapeaux": [],
      "methode": "potentiel radon de l'IRSN et relevé Géorisques de la commune",
      "donnees_du": "2026-11-11",
      "source": "IRSN pour le radon, Géorisques pour les autres risques quand la commune est relevée"
    }
  },
  "poi_500m": {
    "transports": 59,
    "ecoles": 8,
    "commerces": 51,
    "sante": 13,
    "loisirs": 4,
    "restauration": 283,
    "total": 418,
    "score_marche_a_pied": 100,
    "score_qualite_vie": 85,
    "qualite": {
      "n": null,
      "provenance": "mesure",
      "incertitude": null,
      "drapeaux": [],
      "methode": "points d'intérêt dans un rayon de 500 m du centre",
      "donnees_du": "2026-05-17",
      "source": "OpenStreetMap (ODbL), points d'intérêt à 500 m du centre de la commune"
    }
  },
  "phrases": [
    "Dans la commune : 60 écoles, 27 collèges et lycées, 159 médecins généralistes, 35 pharmacies, 333 commerces alimentaires de proximité (INSEE, Base permanente des équipements 2024).",
    "Gare la plus proche : Rouen Rive Droite, gare nationale, à 0,7 km ; aéroport à vols réguliers le plus proche : Deauville Normandie, à 69 km, à vol d'oiseau depuis le centre habité de la commune.",
    "En 2024, pour 1 000 habitants : 2,8 cambriolages de logement (3,4 en moyenne), 7,8 violences physiques hors cadre familial (3,6 en moyenne), 24,6 vols sans violence contre des personnes (10,8 en moyenne), 12,1 destructions et dégradations volontaires (8,5 en moyenne). Moyenne des communes dont les chiffres sont publiés. Source : Ministère de l'Intérieur (SSMSI), délinquance enregistrée par la police et la gendarmerie.",
    "Potentiel radon de catégorie 1 sur 3 (IRSN) ; inondation faible, argiles moyen, mouvements de terrain faible (Géorisques). Pour l'adresse précise, l'état des risques est obligatoire avant tout achat."
  ],
  "sources": [
    "INSEE, Base permanente des équipements 2024",
    "Gares de voyageurs SNCF Open Data (ODbL) et aéroports à vols réguliers (OurAirports), distances à vol d'oiseau depuis le centre habité de la commune",
    "Ministère de l'Intérieur (SSMSI), délinquance enregistrée par la police et la gendarmerie",
    "IRSN pour le radon, Géorisques pour les autres risques quand la commune est relevée",
    "OpenStreetMap (ODbL), points d'intérêt à 500 m du centre de la commune"
  ],
  "credits": {
    "debites": 0,
    "restants": null
  }
}

Réponse réelle de l'API à cette entrée, obtenue avec le moteur du bac à sable, donnée du 17/05/2026.

Réponse

  • inseetexte
  • communetexte ou null
  • equipementsobjet ou null
    Afficher les 5 champs
    • perimetretexte
    • comptesobjet
      Afficher les 15 champs
      • totalentier
      • services_particuliersentier
      • commercesentier
      • commerces_alimentairesentier
      • enseignemententier
      • ecolesentier
      • collegesentier
      • lyceesentier
      • sante_socialentier
      • medecins_generalistesentier
      • pharmaciesentier
      • transportsentier
      • garesentier
      • sports_loisirsentier
      • tourismeentier
    • essentiels_absentsliste de textes
    • phrasetexte
    • qualiteobjet

      Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.

      Afficher les 7 champs
      • nentier ou null

        Nombre d'observations derrière la valeur ; null si sans objet.

        0 au moins

      • provenancetexte ou null

        mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.

        Valeurs : mesure, estime

      • incertitudeobjet ou null

        Incertitude de la valeur : fourchette et demi-largeur.

        Afficher les 3 champs
        • demi_largeur_pctnombre ou null

          Demi-largeur de la fourchette, en % de la valeur.

        • basnombre ou null
        • hautnombre ou null
      • drapeauxliste de textes

        Ce qui doit faire lire la valeur avec prudence ; vide si rien.

        Valeurs : prix_atypique, surface_atypique, vente_en_bloc, doublon_probable, date_estimee, peu_d_observations, valeur_imputee, rattachement_incertain, donnee_ancienne

      • methodetexte ou null

        Méthode de calcul ou de rattachement, en clair.

      • donnees_dutexte ou null

        Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).

      • sourcetexte

        Source publique ou moteur Pillr, en clair.

  • accesobjet ou null

    Gare de voyageurs et aéroport à vols réguliers les plus proches, à vol d'oiseau depuis le centre habité.

    Afficher les 4 champs
    • gareobjet ou null
      Afficher les 3 champs
      • nomtexte
      • categorietexte ou null

        Valeurs : nationale, régionale, locale

      • kmnombre
    • aeroportobjet ou null
      Afficher les 3 champs
      • nomtexte
      • iatatexte ou null
      • kmnombre
    • phrasetexte
    • qualiteobjet

      Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.

      Afficher les 7 champs
      • nentier ou null

        Nombre d'observations derrière la valeur ; null si sans objet.

        0 au moins

      • provenancetexte ou null

        mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.

        Valeurs : mesure, estime

      • incertitudeobjet ou null

        Incertitude de la valeur : fourchette et demi-largeur.

        Afficher les 3 champs
        • demi_largeur_pctnombre ou null

          Demi-largeur de la fourchette, en % de la valeur.

        • basnombre ou null
        • hautnombre ou null
      • drapeauxliste de textes

        Ce qui doit faire lire la valeur avec prudence ; vide si rien.

        Valeurs : prix_atypique, surface_atypique, vente_en_bloc, doublon_probable, date_estimee, peu_d_observations, valeur_imputee, rattachement_incertain, donnee_ancienne

      • methodetexte ou null

        Méthode de calcul ou de rattachement, en clair.

      • donnees_dutexte ou null

        Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).

      • sourcetexte

        Source publique ou moteur Pillr, en clair.

  • delinquanceobjet ou null
    Afficher les 5 champs
    • anneeentier ou null
    • populationnombre ou null
    • categoriesliste d'objets
      Afficher les 5 champs
      • cletexte
      • nomtexte
      • nbnombre ou null

        Faits enregistrés ; null quand le ministère ne publie pas (petits effectifs).

      • taux_pour_1000nombre ou null
      • moyenne_pour_1000nombre ou null

        Moyenne des communes dont les chiffres sont publiés, la même année ; null sans moyenne calculée.

    • phrasetexte ou null
    • qualiteobjet

      Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.

      Afficher les 7 champs
      • nentier ou null

        Nombre d'observations derrière la valeur ; null si sans objet.

        0 au moins

      • provenancetexte ou null

        mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.

        Valeurs : mesure, estime

      • incertitudeobjet ou null

        Incertitude de la valeur : fourchette et demi-largeur.

        Afficher les 3 champs
        • demi_largeur_pctnombre ou null

          Demi-largeur de la fourchette, en % de la valeur.

        • basnombre ou null
        • hautnombre ou null
      • drapeauxliste de textes

        Ce qui doit faire lire la valeur avec prudence ; vide si rien.

        Valeurs : prix_atypique, surface_atypique, vente_en_bloc, doublon_probable, date_estimee, peu_d_observations, valeur_imputee, rattachement_incertain, donnee_ancienne

      • methodetexte ou null

        Méthode de calcul ou de rattachement, en clair.

      • donnees_dutexte ou null

        Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).

      • sourcetexte

        Source publique ou moteur Pillr, en clair.

  • risquesobjet
    Afficher les 4 champs
    • radon_classeentier ou null
    • releveobjet ou null
      Afficher les 3 champs
      • inondationtexte

        Valeurs : faible, moyen, fort, inconnu

      • argilestexte

        Valeurs : faible, moyen, fort, inconnu

      • mouvement_terraintexte

        Valeurs : faible, moyen, fort, inconnu

    • phrasetexte
    • qualiteobjet

      Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.

      Afficher les 7 champs
      • nentier ou null

        Nombre d'observations derrière la valeur ; null si sans objet.

        0 au moins

      • provenancetexte ou null

        mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.

        Valeurs : mesure, estime

      • incertitudeobjet ou null

        Incertitude de la valeur : fourchette et demi-largeur.

        Afficher les 3 champs
        • demi_largeur_pctnombre ou null

          Demi-largeur de la fourchette, en % de la valeur.

        • basnombre ou null
        • hautnombre ou null
      • drapeauxliste de textes

        Ce qui doit faire lire la valeur avec prudence ; vide si rien.

        Valeurs : prix_atypique, surface_atypique, vente_en_bloc, doublon_probable, date_estimee, peu_d_observations, valeur_imputee, rattachement_incertain, donnee_ancienne

      • methodetexte ou null

        Méthode de calcul ou de rattachement, en clair.

      • donnees_dutexte ou null

        Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).

      • sourcetexte

        Source publique ou moteur Pillr, en clair.

  • poi_500mobjet ou null

    Points d'intérêt OpenStreetMap à 500 m du centre ; calculés pour quelques centaines de communes seulement.

    Afficher les 10 champs
    • transportsnombre ou null
    • ecolesnombre ou null
    • commercesnombre ou null
    • santenombre ou null
    • loisirsnombre ou null
    • restaurationnombre ou null
    • totalnombre ou null
    • score_marche_a_piednombre ou null

      Score de marche à pied, sur 100.

    • score_qualite_vienombre ou null
    • qualiteobjet

      Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.

      Afficher les 7 champs
      • nentier ou null

        Nombre d'observations derrière la valeur ; null si sans objet.

        0 au moins

      • provenancetexte ou null

        mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.

        Valeurs : mesure, estime

      • incertitudeobjet ou null

        Incertitude de la valeur : fourchette et demi-largeur.

        Afficher les 3 champs
        • demi_largeur_pctnombre ou null

          Demi-largeur de la fourchette, en % de la valeur.

        • basnombre ou null
        • hautnombre ou null
      • drapeauxliste de textes

        Ce qui doit faire lire la valeur avec prudence ; vide si rien.

        Valeurs : prix_atypique, surface_atypique, vente_en_bloc, doublon_probable, date_estimee, peu_d_observations, valeur_imputee, rattachement_incertain, donnee_ancienne

      • methodetexte ou null

        Méthode de calcul ou de rattachement, en clair.

      • donnees_dutexte ou null

        Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).

      • sourcetexte

        Source publique ou moteur Pillr, en clair.

  • phrasesliste de textes
  • sourcesliste de textes
  • creditsobjet

    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).

    Afficher les 2 champs
    • debitesentier

      0 au moins

    • restantsentier ou null

Erreurs possibles

  • 400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
  • 403hors_bac_a_sableUne clé pk_test_ demande une entrée hors du jeu figé de l'opération
Afficher les 11 erreurs communes à toute l'API

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs