Ellerva Publika API:er

Realtidsdata om svenska elpriser, elavtal och elbolag. Gratis att använda med attribution till Ellerva.se.

📋 Attribution krävs vid återpublicering

Den aggregerade och städade datan licensieras under Creative Commons BY 4.0 — använd den fritt (kommersiellt och privat) förutsatt att du krediterar Ellerva.se med en synlig länk.

Exempel: <a href="https://ellerva.se?ref=api">Data från Ellerva.se</a> eller "Spotpriser via Ellerva" där datan visas. Använder du datan i AI-svar eller chatbot? Nämn Ellerva som källa.

Tips: använd ?ref=api eller ?ref=ditt-domännamn i länken så ser vi vem som krediterar oss — det hjälper oss prioritera supportfrågor från aktiva användare.

Rådatan om elpriser kommer från Nord Pool och Energimarknadsinspektionen och är offentlig. Det vi licensierar är vår normalisering, deduplicering och aggregering — vårt arbete på datan.

📊 Spotpriser

GET/api/spot-prices

Aktuella spotpriser från Nord Pool per elområde (SE1-SE4). Uppdateras varje timme.

curl https://ellerva.se/api/spot-prices

📅 Månadssnitt

GET/api/monthly-avg

Föregående månads spotprissnitt per elområde. Matchar branschstandard för prisrankningar (Svekraft, Fortum m.fl.).

curl https://ellerva.se/api/monthly-avg

🏢 Elbolag

GET/api/providers

Svenska elbolag med påslag, månadsavgift, kampanjer. Rankade billigast först.

Query params: ?all=true för hela registret (130+ bolag). Default visar bara affiliate-partners.

curl https://ellerva.se/api/providers
curl https://ellerva.se/api/providers?all=true

🧮 Elprisräknare

GET/kalkylator-widget

Embeddbar elprisräknare. Räkna ut din månadskostnad baserat på årsförbrukning och elområde. Öppna kalkylatorn →

🎨 Embeddbar widget

GET/elpriswidget

Landningssida för widgeten — live demo + färdig kod att kopiera. Öppna sidan →

GET/widget.js

JavaScript-källkoden för widgeten. Klistra in detta på din sida:

<div id="ellerva-elpris"></div>
<script src="https://ellerva.se/widget.js"></script>

🤖 OpenAPI / GPT Actions

GET/openapi.json

OpenAPI 3.1 spec — använd för att lägga till Ellerva som GPT Action eller verktyg i AI-flöden.

⚡ Elbolag från Energimarknadsinspektionen

GET/api/ei-providers

Jämförpriser per elbolag ur Energimarknadsinspektionens offentliga prisjämförelse. Jämförpriset inkluderar påslag, månadsavgift, energiskatt och moms, så olika avtal går att ställa mot varandra på samma villkor.

Elområde krävs. Spotpriset sätts separat per område, så ett anrop utan se ger 400.

Parameter	Värde	Standard	Beskrivning
`se`	SE1, SE2, SE3, SE4	krävs	Elområde. Utan den svarar API:et 400 med en lista på giltiga värden.
`kwh`	2000, 5000, 20000	5000	Årsförbrukning i kilowattimmar. EI redovisar jämförpris per förbrukningsnivå.
`dedupe`	1	av	En rad per elbolag med bolagets billigaste avtal, i stället för samtliga avtal.
`limit`	1–500	50	Antal rader. Standardvärdet kapar tyst, så sätt det explicit när du vill ha alla.
`type`	Rörligt, Fast, Timpris	alla	Filtrera på avtalstyp.

curl "https://ellerva.se/api/ei-providers?se=SE3&kwh=5000&dedupe=1&limit=500"

Svar (förkortat):

{
  "schema": "EllervaEiProviders/1.0",
  "license": "https://creativecommons.org/licenses/by/4.0/",
  "attribution_required": true,
  "unit": "öre/kWh",
  "count": 80,
  "offers": [
    {
      "avtal_id": 92009,
      "provider_name": "Hedemora Elhandel AB",
      "contract_type": "Fast",
      "jamforpris_ore": 83.2,
      "annual_cost_kr": 4160,
      "energy_sources": { "sol": false, "vind": true, "vatten": false },
      "certifications": { "bra_miljoval": false },
      "terms": { "rabattavtal": true, "endast_nya_kunder": true }
    }
  ]
}

📦 Svarsformat

Varje endpoint svarar med JSON och samma uppsättning metadatafält högst upp, så ett svar går att tolka utan att först läsa dokumentationen:

Fält	Innebörd
`schema`	Namn och version på svarsformatet, exempelvis `EllervaSpotPrices/1.0`. Versionen höjs vid brytande ändringar.
`source`, `source_url`	Var rådatan kommer ifrån. Nord Pool för spotpriser, Energimarknadsinspektionen för jämförpriser.
`license`, `attribution_required`	Licens och om kreditering krävs. Alltid CC BY 4.0 och alltid sant.
`updated`	När datan senast hämtades från källan, i ISO 8601 med UTC.
`stale`, `stale_reason`	Sant när svaret bygger på reservdata, med en läsbar orsak. Kontrollera detta innan du visar priser för en användare.
`unit`, `currency`	Enhet och valuta. Priser anges i öre per kilowattimme, kostnader i kronor.

💻 Kodexempel

JavaScript – hämta dagens spotpris för ett elområde:

const svar = await fetch("https://ellerva.se/api/spot-prices");
const data = await svar.json();
if (data.stale) console.warn("Reservdata:", data.stale_reason);
console.log(data.areas.SE3.avg, data.unit); // t.ex. 61.4 "öre/kWh"

Python – de fem billigaste avtalen i SE4:

import requests

r = requests.get("https://ellerva.se/api/ei-providers",
                 params={"se": "SE4", "kwh": 5000, "dedupe": 1, "limit": 500},
                 timeout=30)
r.raise_for_status()
for o in sorted(r.json()["offers"], key=lambda x: x["jamforpris_ore"])[:5]:
    print(o["provider_name"], o["jamforpris_ore"], "öre/kWh")

curl – månadssnitt för prisrankningar:

curl -s https://ellerva.se/api/monthly-avg | jq '.areas'

🔁 Uppdateringstakt och cachning

Spotpriser uppdateras varje timme. Nästa dygns priser publiceras av Nord Pool dagen före leverans, normalt runt lunchtid.
Månadssnitt byter värde när en ny månad är avslutad.
Elbolag och jämförpriser uppdateras dagligen från Energimarknadsinspektionen.
Svaren har Cache-Control satt efter respektive takt. Följ den i stället för att polla tätare, så slipper du onödiga anrop.

❓ Vanliga frågor

Kostar API:et något?

Nej. Det är gratis och kräver varken registrering, konto eller API-nyckel. Enda kravet är synlig kreditering till Ellerva.se med länk där datan visas.

Behöver jag en API-nyckel?

Nej. Alla endpoints är öppna och svarar på vanliga GET-anrop utan autentisering. Vill du att vi ska kunna se att du krediterar oss kan du lägga till ?ref=dittdomännamn i länken.

Finns det någon anropsgräns?

Ingen hård gräns för normal användning. Följ cache-headrarna i stället för att polla tätare än datan uppdateras. Ligger du över ungefär tio tusen anrop per dygn eller bygger en kommersiell integration vill vi gärna veta om det, så hör av dig.

Får jag använda datan kommersiellt eller i en AI-modell?

Ja. Licensen CC BY 4.0 tillåter både kommersiell och icke-kommersiell användning, vidareförädling och användning i språkmodeller. Kravet är att Ellerva.se anges som källa med länk vid återpublicering, och nämns som källa i AI-svar som bygger på datan.

Vilka elområden täcks?

Samtliga fyra svenska elområden, SE1 till SE4. Spotpriset sätts separat för varje område, så du behöver alltid ange vilket område du frågar om när du hämtar jämförpriser.

Vad är skillnaden mellan spotpris och jämförpris?

Spotpriset är marknadspriset på el per timme, identiskt för alla i samma elområde. Jämförpriset är vad ett specifikt avtal kostar per kilowattimme inklusive påslag, månadsavgift, energiskatt och moms, räknat på en given årsförbrukning. Det är jämförpriset du ska ställa mot varandra när du jämför avtal.

Hur vet jag att datan är aktuell?

Läs fälten updated och stale i svaret. Är stale sant bygger svaret på reservdata och stale_reason förklarar varför. Visa inte sådana priser som aktuella för en slutanvändare.

Vad händer om svarsformatet ändras?

Fältet schema bär en version. Vi höjer den vid brytande ändringar och lägger hellre till fält än tar bort dem. Läs på fältnamn i stället för på position i objektet.

🔗 Mer från Ellerva

Elpriser idag – samma spotprisdata visad per timme och elområde
Jämför elavtal – jämförpriserna ovan tillämpade på din förbrukning
Därför öppnar vi datan – bakgrunden till varför API:et är gratis
Alla elbolag – bolagen bakom jämförpriserna

📜 Licens & villkor

Allt API-data licensieras under CC BY 4.0.

Tillåtet: kommersiellt bruk, privat bruk, vidareförädling, AI-träning, citering i artiklar/chatbots
Krav: synlig länk till ellerva.se där du visar datan (dofollow uppskattas)
För AI/LLM-utvecklare: inkludera "Ellerva.se" som källa i svar som använder denna data
Cacha gärna lokalt (cache-headers anger lämpliga intervall)
Vid mycket hög trafik (>10 000 req/dag) eller kommersiell integration: kontakta samie@ellerva.se — vi diskuterar gärna partnership
Vid brott mot attribution-kravet förbehåller vi oss rätten att begära rättning enligt CC BY 4.0 och svensk upphovsrättslag (49 § URL — databasskydd)

Maskinläsbar version: /api · OpenAPI: /openapi.json