Par Selectra compare les offres d'énergie depuis 2007 et met à jour quotidiennement sa base de tarifs, à chaque mouvement de grille chez un fournisseur. Cette base est ouverte aux acteurs du marché sous forme d'API sur api.selectra.com, où l'abonnement se souscrit en ligne.
Si votre besoin est le prix heure par heure, pour piloter des appareils, c'est une autre API : lisez notre article dédié à l'API de planning des prix.
Quelles données renvoie l'API ?
L'API expose la donnée qui alimente le comparateur de Selectra. Pour chaque offre, vous récupérez :
- le prix de l'abonnement et le prix du kWh, hors taxes et TTC, pour chaque puissance de compteur de 3 à 36 kVA ;
- toutes les options tarifaires : base, heures pleines / heures creuses, Tempo et EJP ;
- le fournisseur, le nom de l'offre, son type (électricité, gaz ou duale) et sa clientèle (particulier ou professionnel) ;
- la disponibilité de l'offre, sa portée nationale ou locale, et le fait qu'il s'agisse ou non d'un tarif réglementé ;
- la date de dernière mise à jour de la grille ;
- des caractéristiques directement exploitables comme filtres : prix fixe, prix indexé, offre verte, offre en ligne, offre avec engagement.
Les signaux d'effacement français sont couverts au même titre que les options classiques, ce qui vous évite d'avoir à les modéliser vous-même.
| Option tarifaire | Prix renvoyés |
|---|---|
| Base | Abonnement et prix du kWh |
| Heures pleines / heures creuses | Abonnement, prix du kWh en heures pleines et en heures creuses |
| Tempo | Abonnement et six prix du kWh : bleu, blanc et rouge, en heures pleines et en heures creuses |
| EJP | Abonnement, prix du kWh en heures normales et en pointe mobile |
Les trois méthodes de l'API
Les trois méthodes sont en lecture seule et s'authentifient avec le même jeton. Elles répondent à trois questions différentes : quel est le catalogue du marché, que vaut précisément une offre, et laquelle retenir pour un client donné.
Lister les fournisseurs et leurs offres
La première méthode renvoie tous les fournisseurs et, pour chacun, l'ensemble de ses offres d'électricité et de gaz, actuelles ou historiques : identifiant, nom, type d'énergie, clientèle visée et date de dernière mise à jour. C'est la méthode qui sert à construire, puis à tenir à jour, votre propre référentiel d'offres.
Obtenir le détail tarifaire d'une offre
La deuxième méthode renvoie, pour un identifiant d'offre, la grille complète : le prix de l'abonnement et du kWh pour chaque puissance et chaque option, hors taxes et TTC, avec la date de mise à jour et l'indication d'un éventuel tarif réglementé. C'est la méthode à rappeler quand une offre bouge.
Comparer les offres pour un client donné
La troisième méthode fait le calcul à votre place. Vous transmettez le code INSEE de la commune, le type d'énergie, la puissance du compteur et les consommations annuelles (base, heures pleines, heures creuses, gaz) ; l'API renvoie les offres classées, avec le coût annuel estimé et l'écart de prix associé, la note du fournisseur et le nombre d'avis clients agrégés, les avantages, les inconvénients et les conditions de durée de chaque contrat. Des filtres permettent de restreindre le classement aux offres à prix fixe, indexées, vertes, en ligne, avec ou sans engagement, ou à une liste de fournisseurs.
Centraliser les efforts de mise à jour des tarifs
Un point d'attention particulier des autorités sur la diffusion d'offres d'énergie est la présentation de tarifs et de caractéristiques à jour. En centralisant les efforts avec un équivalent temps plein dédié, Selectra offre une garantie de toujours disposer des bons tarifs.
Contrairement à la méthode qui consiste à laisser les fournisseurs saisir leurs tarifs, Selectra collecte les données à chaque changement de grille, grâce à ses liens privilégiés avec les acteurs du marché.
Enfin, c'est la garantie de disposer de tous les tarifs et non seulement d'un nombre limité de fournisseurs. Ce point est particulièrement important dans la mesure où consommateurs comme autorités attendent des comparateurs un certain niveau d'exhaustivité dans le panel présenté.
Combien coûte l'accès à l'API ?
L'accès complet à l'API des tarifs d'électricité et de gaz en France coûte 700 € HT par mois, auxquels s'ajoutent 0,01 € HT par requête. L'abonnement est sans engagement et se résilie à tout moment depuis votre espace client. Une erreur de nos serveurs n'est jamais facturée.
Ce tarif reste inférieur au coût d'une ressource dédiée à la collecte et à la vérification des grilles tarifaires, et il offre des garanties supplémentaires d'exactitude des informations diffusées.
Il n'y a pas de palier gratuit sur cette API. L'API de planning des prix, elle, en propose un : 60 requêtes par mois, sans carte bancaire, pour les équipes techniques qui veulent d'abord tester.
Comment démarrer ?
- Créez votre compte sur api.selectra.com, puis souscrivez à l'API Comparateur ;
-
Générez un jeton depuis votre espace, et envoyez-le sur chaque appel dans l'en-tête
Authorization: Bearer; - La documentation détaille les paramètres et le format des réponses, méthode par méthode.
Un doute sur le périmètre ou sur l'intégration ? Appelez Aurian de Maupeou au 06 47 39 40 42, ou partez de la page de l'API.
Les autres API de Selectra
- l'API de planning des prix de l'électricité, qui conjugue heures creuses, prix dynamiques et offres, dans 207 pays et territoires ;
- l'API IBAN de Selectra, qui valide un IBAN et renvoie le BIC et le nom de la banque.