Widget et API DPE Facile

Intégrez les données DPE par commune sur votre site (agence immobilière, mairie, notaire, blog éditorial) en deux lignes de code. Gratuit, sans clé API, sans tracking.

Widget JavaScript — démo

Voici un exemple de widget pour la commune de Toulouse :

Comment l'intégrer ?

Copiez ce code à l'endroit où vous voulez afficher le widget :

<div data-dpefacile-commune="toulouse"></div>
<script src="https://www.dpefacile.com/widget.js" async></script>

Remplacez toulouse par le slug de la commune cible (le slug est visible dans l'URL de la page, par exemple marseille, lyon, bordeaux...). Plusieurs widgets peuvent coexister sur une même page.

API JSON publique

Si vous préférez consommer les données directement, l'endpoint JSON par commune est accessible librement :

GET https://www.dpefacile.com/api/commune/{slug}.json

Exemple de réponse pour /api/commune/toulouse.json :

{
  "commune": {
    "code_insee": "31555",
    "nom": "Toulouse",
    "slug": "toulouse",
    "population": 514819,
    "departement": { "code": "31", "nom": "Haute-Garonne" },
    "region": "76"
  },
  "dpe": {
    "total": 180509,
    "classe_dominante": "C",
    "conso_mean_kwhep_m2_an": 178,
    "ges_mean_kg_co2_m2_an": 12,
    "passoires_fg_pct": 3.1,
    "distribution": { "A": 1234, "B": 5678, ... },
    "type_batiment_dominant": { "type": "appartement", "pct": 67.2 },
    "energie_dominante": { "energie": "Gaz naturel", "pct": 41.5 }
  },
  "meta": {
    "source": "ADEME — DPE Logements existants depuis juillet 2021",
    "license": "Licence Ouverte 2.0",
    "page_html": "https://www.dpefacile.com/dpe/toulouse/",
    "generated_at": "2026-05-23"
  }
}

Licence

Les données sont fournies sous Licence Ouverte 2.0 (Etalab), cohérente avec celle de la source ADEME DPE Logements existants. Vous pouvez les réutiliser à des fins commerciales et non commerciales, sous réserve de mentionner la source.

Mention recommandée : "Données issues de DPE Facile (data ADEME, Licence Ouverte 2.0)".

Bonnes pratiques

• Le widget est mis en cache 1 h côté CDN. Inutile de le placer en plusieurs exemplaires sur la même page sauf pour des communes différentes.
• Le widget ne dépose aucun cookie et n'envoie aucune donnée utilisateur.
• Le widget est servi sur HTTPS via CloudFront — vous pouvez l'intégrer sur un site sécurisé sans warning mixed-content.
• Pour un usage intensif (10 000+ communes/jour), pré-téléchargez les JSON localement et servez-les depuis votre CDN.

Cas d'usage

• Agents immobiliers : afficher le contexte DPE de la commune sur la fiche d'une annonce.
• Notaires : enrichir les présentations de bien avec les statistiques locales.
• Mairies et collectivités : publier les indicateurs DPE de la commune sur le site officiel.
• Blogs immobiliers : illustrer un article comparatif avec des données factuelles.
• Plateformes de rénovation énergétique : contextualiser une demande de devis.

Contact

Questions, suggestions, partenariat ? Écrivez-nous.