Ellervas publika API:er

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

📊 Spotpriser

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

📅 Månadssnitt

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

🏢 Elbolag

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

🧮 Elprisräknare

🎨 Embeddbar widget

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

🤖 OpenAPI / GPT Actions

⚡ Jämförpriser per elbolag

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

{
  "schema": "EllervaElbolagPriser/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:

💻 Kodexempel

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"

import requests

r = requests.get("https://ellerva.se/api/elbolag-priser",
                 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 -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.
• 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 kvart (15 minuter), identiskt för alla i samma elområde. Jämförpriset är vad elhandeln i ett specifikt avtal kostar per kilowattimme inklusive påslag, månadsavgift och moms, räknat på en given årsförbrukning. Elnätsavgift och energiskatt tillkommer. 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