{
  "schema": "EllervaPublicApiIndex/1.0",
  "description": "Publika API-endpoints från Ellerva.se. Realtidsdata om svenska elpriser, elavtal och elbolag. Gratis att använda med attribution.",
  "source": "Ellerva.se",
  "source_url": "https://ellerva.se",
  "attribution": "Data från Ellerva.se — vid publicering krävs synlig länk till https://ellerva.se (CC BY 4.0)",
  "license": "https://creativecommons.org/licenses/by/4.0/",
  "attribution_required": true,
  "contact": "samie@ellerva.se",
  "documentation": "https://ellerva.se/api/docs",
  "openapi": "https://ellerva.se/openapi.json",
  "updated": "2026-06-12T05:47:38.455Z",
  "endpoints": [
    {
      "path": "/api/spot-prices",
      "method": "GET",
      "description": "Aktuella spotpriser per elområde (SE1-SE4) från Nord Pool. Uppdateras varje timme.",
      "unit": "öre/kWh",
      "cache_max_age": 900,
      "example": "https://ellerva.se/api/spot-prices"
    },
    {
      "path": "/api/monthly-avg",
      "method": "GET",
      "description": "Föregående månads spotprissnitt per elområde. Matchar branschstandard för prisrankningar.",
      "unit": "öre/kWh",
      "cache_max_age": 21600,
      "example": "https://ellerva.se/api/monthly-avg"
    },
    {
      "path": "/api/providers",
      "method": "GET",
      "description": "Svenska elbolag med påslag, månadsavgift och kampanjer. Rankade billigast först. Default: bara affiliate-partners.",
      "query_params": {
        "all": "true för hela registret (260+ bolag)"
      },
      "cache_max_age": 3600,
      "example": "https://ellerva.se/api/providers"
    },
    {
      "path": "/api/ei-providers",
      "method": "GET",
      "description": "Per-leverantör jämförpriser från Energimarknadsinspektionen (EI). 260+ elbolag, jämförpris inkl. påslag, månadsavgift, energiskatt och moms.",
      "attribution_required": "Synlig länk till ellerva.se krävs vid publicering (CC BY 4.0)",
      "query_params": {
        "se": "SE1/SE2/SE3/SE4 (obligatorisk)",
        "kwh": "2000/5000/20000 (default 5000)",
        "type": "Fast/Rörligt/Timpris/Mix (valfri)",
        "limit": "1-500 (default 50)",
        "dedupe": "1 = en rad per leverantör med billigaste avtalet"
      },
      "cache_max_age": 21600,
      "example": "https://ellerva.se/api/ei-providers?se=SE3&kwh=5000&dedupe=1"
    },
    {
      "path": "/kalkylator-widget",
      "method": "GET",
      "description": "Embeddbar elprisräknare. Räkna ut din månadskostnad baserat på årsförbrukning och elområde.",
      "type": "html_page",
      "example": "https://ellerva.se/kalkylator-widget"
    },
    {
      "path": "/elpriswidget",
      "method": "GET",
      "description": "Landningssida för Ellerva-widgeten. Visar live demo + kopiera-och-klistra-kod för att bädda in spotpriser på din webbplats.",
      "type": "html_page",
      "example": "https://ellerva.se/elpriswidget"
    },
    {
      "path": "/widget.js",
      "method": "GET",
      "description": "JavaScript-källkoden för Ellerva-widgeten. Använd via /elpriswidget eller direkt: <div id='ellerva-elpris'></div><script src='https://ellerva.se/widget.js'></script>",
      "type": "javascript",
      "cache_max_age": 3600,
      "example": "https://ellerva.se/widget.js"
    },
    {
      "path": "/openapi.json",
      "method": "GET",
      "description": "OpenAPI 3.1 spec för GPT Actions och verktygsintegration.",
      "example": "https://ellerva.se/openapi.json"
    }
  ]
}