Kort: geen aanmelding, geen sleutel. Statische bestanden onder
/api/v1/, vrij te gebruiken onder CC BY 4.0 met bronvermelding: energiefilter.nl, https://energiefilter.nl/data/downloads/. Er staan geen partner-, affiliate- of trackinggegevens in.Endpoints
| URL | Inhoud |
|---|---|
/api/v1/contracts.json | 54 contractrecords met tarieven, bron-URL en controledatum (zelfde velden als de open data) |
/api/v1/suppliers.json | 18 leveranciers met aantal contracten en een link naar hun pagina op energiefilter.nl |
/api/v1/history.json | De tarievenhistorie: meetpunten, dagelijkse controles en gevonden wijzigingen |
/api/v1/index.json | Overzicht van de endpoints |
Voorbeeld
curl https://energiefilter.nl/api/v1/contracts.json
fetch("https://energiefilter.nl/api/v1/suppliers.json")
.then(r => r.json())
.then(d => console.log(d.suppliers.map(s => s.name)));
Elk bestand begint met een veld peildatum (de datum van onze dataset), de licentie en de bronvermelding. Een leeg veld (null) betekent: onbekend. Wij schatten niets.
Afspraken
- Versie.
v1blijft werken zoals beschreven. Er kunnen velden bijkomen; verandert er iets wat bestaande velden breekt, dan komt er/api/v2/en blijft v1 nog minstens drie maanden bestaan. - Ververs. De bestanden worden bijgewerkt als we een nieuwe release plaatsen, niet per dag. Cache ze gerust een uur of langer en haal ze niet elke paar seconden op.
- Geen garantie. Dit is een gratis dienst zonder beschikbaarheidsgarantie en geen advies. Controleer tarieven altijd bij de leverancier.
- Bronvermelding. Vermeld "energiefilter.nl" met een link naar https://energiefilter.nl/data/downloads/. Gebruik je alleen de historie, dan mag je ook naar de historiepagina linken.
- Wat niet. Geen partnerlinks, welkomstbonussen of eigen notities, en geen gegevens van bezoekers.
Velden van contracts.json
| Veld | Betekenis |
|---|---|
supplier_id | Interne code van de leverancier |
supplier_name | Naam leverancier |
contract_type | Contractvorm (vast, variabel, dynamisch) |
term_months | Looptijd in maanden (leeg: niet vastgelegd of variabel) |
energy_type | Stroom, gas of beide |
fixed_cost_electricity | Vaste leveringskosten stroom per maand, incl. btw, indien apart bekend |
fixed_cost_gas | Vaste leveringskosten gas per maand, incl. btw, indien apart bekend |
fixed_cost_both_per_month | Vaste leveringskosten stroom en gas samen per maand, indien alleen samen bekend |
unit_price_electricity | Stroomprijs per kWh incl. energiebelasting en btw (leeg: onbekend) |
unit_price_electricity_basis | Grondslag van de stroomprijs |
unit_price_gas | Gasprijs per m³ incl. energiebelasting en btw (leeg: onbekend) |
feed_in_cost_method | Hoe terugleverkosten worden gerekend (per_kwh, tier, unknown) |
feed_in_cost_value | Terugleverkosten volgens de leverancier |
feed_in_compensation | Terugleververgoeding volgens de leverancier |
feed_in_cost_2027_per_kwh | Terugleverkosten die de leverancier voor 2027 noemt, per kWh |
feed_in_compensation_2027_per_kwh | Terugleververgoeding die de leverancier voor 2027 noemt, per kWh |
feed_in_source_url | Pagina van de leverancier waar de terugleverbedragen staan |
feed_in_checked_at | Datum van controle van de terugleverbedragen (jjjj-mm-dd) |
network_cost_method | Hoe netbeheerkosten zijn meegenomen |
source_url | Pagina van de leverancier waar het tarief staat |
source_type | supplier_site (leverancier zelf) of aggregator (overzicht van derden) |
source_checked_at | Datum van controle (jjjj-mm-dd) |
source_valid_from | Ingangsdatum volgens bron |
source_valid_until | Einddatum volgens bron |
address_assumption | Testadres/aanname voor de netbeheerder |
calculable | Volledig doorgerekend voor 2026 (true/false) |
calculable_2027 | Volledig doorgerekend voor het scenario 2027 (true/false) |
missing_fields | Velden die ontbreken (gescheiden door ;) |
Velden van history.json
reeksen[]: per leverancier, contract en grootheid (metric) een lijstpuntenmetdatum,waardeensoort(waarnemingofbevestigd).controles[]: per dag het aantal gevonden wijzigingen, ongewijzigde en mislukte bronnen uit de dagelijkse tariefcheck.wijzigingen[]: gevonden verschillen metoudennieuw; leeg zolang er geen zijn.
Uitleg over wat de reeks wel en niet zegt: tarievenhistorie. Zelf een vergelijker op je site? Zie de widget. Vragen: [email protected].