API

De open brandstofprijs-API van Nederland

Actuele pompprijzen en locaties van tankstations als JSON. Open voor iedereen, met bronvermelding.

GET https://checktankr.nl /api/stations?lat=52.09&lng=5.12&brandstof=euro95&straal=10

Actuele pompprijzen, locaties en landelijke gemiddelden als JSON. Gratis voor normaal gebruik, zonder sleutel, met bronvermelding "Prijzen: Tankr". Deze endpoints zijn in bèta; een stabiele /v1 met API-sleutels, historie en bulk-export volgt.

GET /api/stations

Goedkoopste stations rond een punt, met prijs, afstand, bron en versheid.

  • lat, lng: verplicht, binnen Nederland
  • brandstof: euro95 (standaard), euro98, diesel, lpg
  • straal: in km, 1 tot 50 (standaard 10)
  • limit: 1 tot 100 (standaard 20)
{
  "center": { "lat": 52.09, "lng": 5.12 },
  "fuel": "euro95",
  "radius_km": 10,
  "count": 2,
  "stations": [
    {
      "id": 1234,
      "brand": "TinQ",
      "name": "TinQ Utrecht Overvecht",
      "address": { "street": "Einsteindreef", "house_number": "10",
                   "postcode": "3562 XV", "city": "Utrecht", "province": "Utrecht" },
      "lat": 52.1133, "lng": 5.1162,
      "unmanned": true,
      "distance_km": 2.6,
      "price": 2.119, "price_cents": 2119,
      "observed_at": "2026-11-07T10:05:00.000Z",
      "freshness": "actueel",
      "source": "scrape"
    }
  ]
}

GET /api/averages

Landelijk gemiddelde per brandstof (CBS, dagcijfer) met het verschil met de dag ervoor.

{
  "averages": [
    { "fuel": "euro95", "date": "2026-11-05",
      "price": 2.284, "price_cents": 2284, "delta_cents": -17 }
  ],
  "source": "CBS StatLine 80416ned (CC BY 4.0)"
}

GET /api/stats/{statistiek}

De cijfers achter de statistiekenpagina, berekend uit eigen Tankr-waarnemingen en CBS-dagcijfers. Elk antwoord heeft een veld enough: false betekent dat er nog te weinig data is en dat je het cijfer niet als conclusie moet tonen. De drempel staat erbij (bijvoorbeeld min_stations). Onze eigen historie begint op 7 november 2026 en groeit met elke nieuwe prijsupdate.

  • /api/stats/averages: gemiddelde per brandstof vandaag, van Tankr (met aantal stations) en CBS, elk met het verschil met de dag ervoor
  • /api/stats/history?dagen=30: dagreeks per brandstof, CBS en Tankr; dagen 7 tot 90
  • /api/stats/weekdays?brandstof=euro95: gemiddelde afwijking per weekdag t.o.v. de week eromheen, met de goedkoopste en duurste dag; source zegt of het om Tankr- of CBS-data gaat
  • /api/stats/distribution?brandstof=euro95: verdeling van actuele prijzen in stappen van 2 ct rond het gemiddelde, met percentielen
  • /api/stats/chains?brandstof=euro95: gemiddelde per keten, goedkoopste en duurste
  • /api/stats/regions?brandstof=euro95: gemiddelde per provincie (via postcode) en per plaats
  • /api/stats/coverage: aantal stations met een actuele prijs, per brandstof en per bron
{
  "fuel": "euro95",
  "source": "cbs",
  "weekdays": [
    { "day": "maandag", "deviation": 7, "samples": 4 },
    { "day": "zaterdag", "deviation": -6.8, "samples": 4 }
  ],
  "cheapest": "zaterdag",
  "most_expensive": "maandag",
  "days_used": 30,
  "enough": true,
  "min_samples_per_weekday": 2
}

In de statistieken is price_cents net als elders de prijs ×1000; afwijkingen (deviation, delta_cents) gebruiken dezelfde eenheid, dus 10 is 1 cent per liter. Dagen volgen de Nederlandse tijd.

Prijzen en versheid

Prijzen staan in euro per liter met drie decimalen; price_cents is dezelfde prijs ×1000 als geheel getal. freshness is actueel (< 3 uur), recent (< 24 uur) of verouderd; verouderde prijzen komen niet in /api/stations. source is nu altijd scrape (website van de keten). Later komen daar owner (het station zelf) en user (een bezoeker) bij.

Gebruik

Gratis voor normaal gebruik, met bronvermelding "Prijzen: Tankr". Gebruik de API redelijk; bij misbruik kunnen we een limiet instellen. Antwoorden worden 5 minuten gecachet. Locaties zijn afgeleid van OpenStreetMap (ODbL). Voor intensief gebruik, historie of een datafeed voor je station: neem contact op.

Binnenkort: Tankr in ChatGPT, Claude en je navigatie

Dezelfde data komt beschikbaar als MCP-server, zodat AI-assistenten prijzen kunnen opvragen en tankstations hun prijzen kunnen doorgeven, in gewone taal. Houd me op de hoogte.

Aan de slag

Tank slimmer en betaal nooit meer te veel.