API éCO2mix : comment brancher vos outils sur les données de RTE

Les données du système électrique français publiées par RTE sous le nom éCO2mix se récupèrent par programme, gratuitement et sans clé d’authentification. Consommation nationale, production par filière, taux de CO2, échanges aux frontières : tout transite par des jeux de données ouverts, interrogeables en JSON ou en CSV et rafraîchis tous les quarts d’heure. Reste à savoir où frapper, ce que renvoie la réponse et quelles limites respecter.

Où se trouve l’API éCO2mix ?

RTE ne maintient pas d’API portant la marque éCO2mix. Les mêmes mesures alimentent l’application mobile et le portail ODRÉ, qui rend les données publiques de l’énergie exploitables (Open Data Réseaux Énergies), qui les expose via l’API Explore d’Opendatasoft. Chaque jeu de données possède son propre identifiant : eco2mix-national-tr pour le national en temps réel, eco2mix-regional-tr pour la maille régionale, eco2mix-national-cons-def pour les séries consolidées et définitives.

L’appel prend la forme d’une URL de la famille /api/explore/v2.1/catalog/datasets/{identifiant}/records, complétée par des paramètres de requête : limit pour le nombre d’enregistrements, where pour filtrer sur une plage de dates, select pour ne demander que les champs utiles, order_by pour trier. Chaque page de jeu de données embarque une console qui construit la requête et affiche la réponse, pratique pour tester avant d’écrire la moindre ligne de code. Un miroir de ces jeux existe sur data.gouv.fr et pointe vers la même source.

Ce que renvoie un enregistrement éCO2mix

Un enregistrement national temps réel couvre un pas de quinze minutes et empile une quarantaine de champs. Le détail va bien au-delà des grands agrégats affichés sur les tableaux de bord grand public :

• la consommation réalisée, accompagnée de la prévision établie la veille et de celle réactualisée le jour même ;
• la production filière par filière : nucléaire, gaz, fioul, charbon, hydraulique, solaire, éolien avec séparation terrestre et offshore, bioénergies ;
• le découpage technologique fin : cycles combinés gaz, cogénération, turbines à combustion, hydraulique au fil de l’eau, lacs, stations de pompage ;
• le taux de CO2 estimé de la production française, en grammes par kilowattheure ;
• les échanges physiques et commerciaux avec l’Angleterre, l’Espagne, l’Italie, la Suisse, l’Allemagne et la Belgique ;
• le stockage et le déstockage sur batteries, arrivés avec le développement récent des parcs.

Deux détails de lecture évitent des contresens. Les échanges physiques s’affichent en négatif quand la France exporte. Le pompage apparaît lui aussi en valeur négative, puisqu’il consomme de l’électricité pour remonter l’eau vers les bassins hauts des stations de transfert d’énergie. Dernière subtilité de calendrier : les échanges commerciaux sortent au pas demi-heure quand le reste suit le pas quart d’heure.

Temps réel, consolidées ou définitives : quelle version choisir ?

Les mêmes grandeurs existent en trois âges et le choix dépend entièrement de l’usage.

Nature	Fraîcheur	Origine	Usage adapté
Temps réel	toutes les 15 minutes	télémesures, forfaits et estimations	affichage live, domotique, alertes
Consolidées	mise à jour quotidienne	comptages des partenaires	suivi mensuel, reporting
Définitives	milieu d’année A+1	comptages transmis et vérifiés	études, publications, séries longues

Les valeurs temps réel du mois en cours se font remplacer par les consolidées au fil des mois suivants, puis par les définitives une fois tous les comptages validés. Un graphique bâti sur le temps réel bouge donc rétroactivement. Pour une étude ou un chiffre destiné à être cité, la série définitive reste la référence.

Quotas, licence et bonnes pratiques d’appel

L’accès reste ouvert, sans inscription ni jeton. Un garde-fou existe malgré tout : des robots aspiraient le jeu national temps réel à des cadences sans rapport avec sa fréquence réelle de mise à jour.

Un quota de 50 000 appels par utilisateur et par mois encadre désormais l’accès aux données éCO2mix nationales temps réel.

Ce plafond laisse une marge confortable pour un usage normal : interroger l’API tous les quarts d’heure représente moins de 3 000 appels mensuels. Quelques réflexes gardent la consommation basse et les temps de réponse courts : caler la fréquence des requêtes sur celle des données, filtrer par date plutôt que tout télécharger, restreindre la liste des champs demandés, stocker localement l’historique une fois pour toutes. Les données circulent sous Licence Ouverte 2.0, qui autorise la réutilisation, y compris commerciale, en créditant la source.

Domotique, dashboards et analyses : ce que les réutilisateurs en font

Le champ d’usage le plus visible reste la maison connectée. Une intégration communautaire pour Home Assistant, installable via HACS, remonte consommation, production par source et échanges internationaux dans des cartes graphiques, avec conversion automatique en gigawatts. Le principe séduit parce qu’il ouvre la porte à des automatisations très concrètes : lancer la recharge d’un véhicule électrique quand le taux de CO2 plonge sous un seuil, décaler un chauffe-eau vers les heures où le solaire sature le réseau. C’est la logique d’un réseau électrique qui ajuste la demande à la production, transposée à l’échelle d’un logement.

D’autres réutilisations prospèrent en dehors du garage domotique : tableaux de bord internes en entreprise, visualisations pédagogiques, travaux universitaires sur l’insertion des renouvelables, articles de presse chiffrés. La granularité au quart d’heure sur plus d’une décennie d’historique transforme éCO2mix en matériau d’analyse rare pour un système électrique national.