# AGSI+, gasopslag in Europa (GIE)

AGSI+ (Aggregated Gas Storage Inventory) van Gas Infrastructure Europe toont per dag hoeveel gas er in de opslagen van elk Europees land zit, hoeveel er is in- en uitgevoerd en hoe vol ze zijn, ook per beheerder. Elke winter nieuws: eind oktober 2025 waren de Nederlandse opslagen volgens het CBS (op basis van AGSI) voor 73,6 procent gevuld. De website is vrij te bekijken; de API vraagt een gratis persoonlijke sleutel en bronvermelding is verplicht.

- Uitgever: Gas Infrastructure Europe
- Gebied: Europa · Laagste detail: land en beheerder, per gasdag
- Periode: niet vastgesteld (zonder sleutel niet na te gaan) · Ververst: dagelijks
- Toegang: Gratis sleutel · Licentie: Gratis, bronvermelding verplicht (GIE, AGSI); geen standaardlicentie
- Koppelsleutels: landcode, gasdag (datum), beheerder
- Status: grijs
- URL: https://agsi.gie.eu/

## Wat kun je ermee?
- **Hoe vol is Nederland voor de winter?.** Volg de vulling van 1 oktober tot 1 november en vergelijk met eerdere jaren. Volgens het CBS was het eind oktober 2021 maar 58 procent, eind oktober 2023 99 procent.
- **Nederland tussen de buurlanden.** AGSI geeft dezelfde cijfers voor Duitsland, België en de rest van Europa. Zet de vulling naast elkaar en kijk wie achterloopt.
- **Wanneer begint het onttrekken?.** De dagcijfers van injectie en onttrekking laten zien wanneer de opslagen van vullen naar leveren omslaan. Leg dat naast de temperatuur van de KNMI.

## Zo verwerk je het
1. **Bekijk eerst de website.** Grafieken en tabellen per land en per beheerder zijn zonder account te zien. Voor een paar cijfers hoef je de API niet te gebruiken.
   `https://agsi.gie.eu/`
2. **Vraag een sleutel aan.** Registreer gratis voor een persoonlijke API-sleutel. Zonder sleutel antwoordt de API met "Invalid or missing API key".
   `https://agsi.gie.eu/account`
3. **Vraag een land op.** Met de sleutel vraag je per land de dagcijfers op. Dit is de aanroep die zonder sleutel de foutmelding gaf (16 okt 2026); de velden hebben we niet kunnen bekijken.
   `https://agsi.gie.eu/api?country=nl&size=1`
4. **Of neem het open CBS-cijfer.** Het CBS publiceert maandelijks de eindvoorraad en de capaciteit van de Nederlandse gasopslagen, op basis van AGSI. Zonder sleutel, als OData.
   `https://opendata.cbs.nl/ODataApi/OData/86103NED/TypedDataSet?$filter=substringof('MM10',Perioden)&$select=Perioden,EindvoorraadGasvormigAardgas_29,OpslagcapaciteitGasvormig_33&$format=json`

## Interessante koppelingen
- Hoeveel sneller loopt de opslag leeg als het vriest? → [knmi-daggegevens](https://www.opendataindex.nl/bron/knmi-daggegevens.md) via datum (gasdag). Zet de dagelijkse onttrekking naast de etmaaltemperatuur van De Bilt. Koude dagen vragen meer gas voor verwarming.
- Klopt het maandcijfer met de dagcijfers? → [cbs-statline](https://www.opendataindex.nl/bron/cbs-statline.md) via maand. Neem de AGSI-stand op de laatste gasdag van de maand en vergelijk met de eindvoorraad in 86103NED. Let op de eenheid: het CBS rekent in miljoen kubieke meter; controleer welke eenheid de AGSI-cijfers hebben.

## Vergelijkbare bronnen
- [cbs-statline](https://www.opendataindex.nl/bron/cbs-statline.md): De CBS-aardgasbalans (86103NED) heeft per maand de voorraad en capaciteit voor heel Nederland, open en zonder sleutel. Geen dagcijfers en geen andere landen.
- [ned-energie](https://www.opendataindex.nl/bron/ned-energie.md): Het Nationaal Energie Dashboard toont de opwek van zon- en windstroom en het gasverbruik in Nederland, maar niet de gasopslag. Ook daar is een sleutel nodig.
- [eurostat](https://www.opendataindex.nl/bron/eurostat.md): Eurostat heeft maandelijkse gascijfers per EU-land, met vertraging, maar geen dagelijkse vulling.

## Waar je op moet letten
- **Sleutel en bronvermelding verplicht.** De API is gratis maar alleen met een persoonlijke sleutel. GIE vraagt dat je GIE of AGSI als bron noemt en kan anders de sleutel intrekken.
- **Een deel van de REMIT-meldingen.** De cijfers komen van de opslagbeheerders en zijn volgens GIE een deel van wat onder de Europese REMIT-regels wordt gemeld. Late correcties komen voor.
- **Vulling is geen voorraad voor Nederland alleen.** Gas in Nederlandse opslagen kan eigendom zijn van handelaren uit andere landen en naar het buitenland stromen. Een volle opslag zegt niet dat het gas voor Nederlandse huishoudens is.
- **Geen eigen controle.** Zonder sleutel konden we de API-velden, de periode en de eenheden niet zelf nagaan. Wat hier over de API staat, komt uit de website en de voorwaarden van GIE.

## API (REST (JSON))

- Basis: https://agsi.gie.eu/api
- Toegang: Registreer gratis op agsi.gie.eu/account (naam, e-mail, bedrijf, toestemming voor gebruiksregistratie en bronvermelding). Je krijgt een persoonlijke sleutel die niet verloopt; stuur die mee in de kop x-key. Zonder sleutel: HTTP 200 met "access denied" / "Invalid or missing API key" en een lege data-lijst. Registratie is volgens de handleiding verplicht voor wie geen data levert. (getest)
- Formaten: json
- Omvang: 128 opslaglocaties en -groepen van 72 beheerders in 22 landen in de EIC-lijst, waarvan in Nederland 7 bij 5 beheerders (16 okt 2026) (getest)
- Filteren: Queryparameters die je combineert: land, dan beheerder, dan opslag (elk niveau vraagt de bovenliggende erbij), plus datums.; =, from/to

### Endpoints
- `GET /api`: Dagcijfers per gasdag voor Europa (type=eu), een land, een beheerder of één opslag: vulling, in- en uitvoer, capaciteit, vullingsgraad. Zonder filters de boom zoals op de voorpagina.
- `GET /api/unavailability`: Meldingen van onbeschikbaarheid (gepland en ongepland) per opslag, met volume en injectie- en onttrekkingscapaciteit die wegvalt.
- `GET /api/about?show=listing`: EIC-lijst van alle beheerders en hun opslagen, met EIC-codes, land, soort en kant-en-klare API-adressen.
- `GET /api/about`: Hiërarchische lijst van beheerders met logo, publicatielinks, tarieven en opslagen.
- `GET /api/news`: Nieuws en mededelingen (correcties, nieuwe opslagen, wisseling van beheerder); ?url=<id> voor één bericht.

### Parameters
- `x-key`: Je persoonlijke API-sleutel. (uit de beschrijving)
- `type`: Europa, niet-EU of aanvullende informatie (bij /api); bij unavailability Planned of Unplanned. (uit de beschrijving)
- `country`: Land, bv. nl of de. (uit de beschrijving)
- `company`: Beheerder (EIC), alleen samen met country; bv. 21X000000001120V voor TAQA Gas Storage. (uit de beschrijving)
- `facility`: Eén opslag (EIC), alleen samen met country en company. (uit de beschrijving)
- `date / from / to`: Eén gasdag, of een reeks gasdagen. Zonder from en to: alles vanaf het begin van de rapportage. (uit de beschrijving)
- `updated`: Alleen records die op of na deze datum zijn bijgewerkt; niet te combineren met een ander datumfilter. (uit de beschrijving)
- `start / end / end_flag`: Alleen /api/unavailability: periode en confirmed of estimate. (uit de beschrijving)
- `page / size / reverse`: Paginering: page begint bij 1, size standaard 30 en hoogstens 300; reverse draait de volgorde om. last_page in het antwoord zegt hoeveel pagina's er zijn. (uit de beschrijving)

### Velden van /api (volgens de handleiding; getallen komen als tekst) (11)
`gasDayStart` datum, `gasInStorage` tekst (getal), `workingGasVolume` tekst (getal), `full` tekst (getal), `injection / withdrawal / netWithdrawal` tekst (getal), `injectionCapacity / withdrawalCapacity` tekst (getal), `consumption / consumptionFull` tekst (getal), `trend` tekst (getal), `status` tekst, `updatedAt` datetime, `info` lijst

### Limieten en valkuilen
- Meer dan 60 aanroepen per minuut (per IP): 60 seconden wachtrij met 'too many requests'; wie dat blijft doen, komt op een zwarte lijst. Elke pagina telt als een aanroep. (uit de beschrijving)
- Nieuwe cijfers één keer per dag, om 19:30 CET, met een tweede ronde om 23:00 voor late beheerders. Vaker ophalen heeft geen zin. (uit de beschrijving)
- size hoogstens 300 per pagina. (uit de beschrijving)
- Een ontbrekende of foute sleutel geeft geen 401 maar HTTP 200 met "error": "access denied" en een lege data-lijst. Controleer altijd op het veld error. (getest)
- Zonder sleutel antwoordden /api/about?show=listing (EIC-lijst), /api/unavailability en /api/news wel met data; /api en /api/about niet. De handleiding zegt toch dat registratie verplicht is voor API-gebruik. (getest)
- Getallen komen als tekst ("65.5257") en ontbrekende waarden als "-". Zet ze zelf om. (uit de beschrijving)
- Historie vanaf 1 januari 2011 (AGSI) of vanaf de start van de opslag, maar niet elke beheerder leverde terug tot 2011; volledig vanaf de REMIT-rapportage (7 april 2016). EIC-codes kunnen veranderen bij een nieuwe beheerder; oude reeksen houden dan een eigen code (vaak PRIOR…). (uit de beschrijving)
- Vulling boven 100% komt voor: de vullingsgraad rekent met de verkoopbare capaciteit, terwijl de technische capaciteit hoger kan liggen. (uit de beschrijving)
- Testomgeving met dezelfde data: https://agsitest.gie.eu/api. agsi.gie.eu heeft geen robots.txt (404). (getest)
- Open alternatief zonder sleutel: CBS-tabel 86103NED (aardgasbalans per maand, met eindvoorraad en capaciteit van de Nederlandse opslagen, op basis van AGSI). (ervaring)


## Voorbeelden met echte cijfers (1)

Per voorbeeld de bevinding, de peildatum en de aanroep die precies deze cijfers ophaalt.

- **Vulling van de Nederlandse gasopslagen eind oktober (CBS, op basis van AGSI): 73,6 procent van de capaciteit in 2025, 21,5 procentpunt lager dan in 2017** (2025). Tabel 86103NED. [Voorbeeld](https://www.opendataindex.nl/voorbeeld/cbs-gasopslag-vulling-oktober)
  - `https://opendata.cbs.nl/ODataApi/OData/86103NED/TypedDataSet?$filter=substringof('MM10',Perioden)&$select=Perioden,EindvoorraadGasvormigAardgas_29,OpslagcapaciteitGasvormig_33&$format=json`