API documentation

Country summary Free

National average, minimum and maximum per fuel type, with the number of contributing stations and the freshness stamp. This is the call most integrations start with.

Returns every live market in one document (about 19 KB). Germany is excluded: we hold the data but do not publish it yet. last_fetched is UTC, normalised from the database clock, and is the number to trust when you decide whether a price is stale.

Response (2 of 21 markets shown)

{
  "ok": true,
  "data": {
    "countries": [
      {
        "country_code": "AD",
        "fuels": {
          "diesel": { "stations": 54, "min": 1.619, "max": 1.64,  "avg": 1.629 },
          "gpl":    { "stations": 1,  "min": 0.876, "max": 0.876, "avg": 0.876 },
          "sp95":   { "stations": 54, "min": 1.609, "max": 1.628, "avg": 1.616 },
          "sp98":   { "stations": 54, "min": 1.669, "max": 1.698, "avg": 1.678 }
        },
        "last_fetched": "2026-09-07 21:07:07",
        "total_stations": 54
      },
      {
        "country_code": "AT",
        "fuels": {
          "diesel": { "stations": 1722, "min": 1.799, "max": 2.449, "avg": 2.092 },
          "sp95":   { "stations": 1592, "min": 1.689, "max": 2.199, "avg": 1.889 }
        },
        "last_fetched": "2026-09-07 18:40:55",
        "total_stations": 2378
      }
    ]
  }
}

Brand breakdown Pro

Average, cheapest and dearest price per retail brand in one market, for one fuel. Brands with fewer than five stations carrying that fuel are left out, so a thin market can legitimately come back empty.

Response (3 of many brands shown)

{
  "ok": true,
  "data": {
    "country": "GB",
    "fuel": "diesel",
    "brands": [
      { "brand_name": "Go",                 "logo_file": null, "station_count": 6,
        "price_min": "1.966", "price_max": "2.083", "price_avg": "2.043" },
      { "brand_name": "Thompson Fuels Ltd", "logo_file": null, "station_count": 6,
        "price_min": "2.059", "price_max": "2.059", "price_avg": "2.059" },
      { "brand_name": "Costco Wholesale",   "logo_file": null, "station_count": 18,
        "price_min": "2.013", "price_max": "2.129", "price_avg": "2.060" }
    ]
  }
}

Nearby stations Pro

Stations inside a radius, nearest first, each with every fuel price we currently hold and when the source last moved it. The workhorse of any “cheapest fuel near me” feature.

Response (first station of three)

{
  "ok": true,
  "data": {
    "country": "FR",
    "center": { "lat": 48.85, "lng": 2.35 },
    "radius": 10,
    "stations": [
      {
        "id": 6808,
        "name": "Station PARIS",
        "brand": null,
        "logo": null,
        "address": "8,10,10bis Rue Bailleul",
        "city": "PARIS",
        "postal_code": "75001",
        "lat": 48.861,
        "lng": 2.341,
        "is_open": true,
        "distance_km": 1.4,
        "prices": {
          "diesel": { "price": 2.68, "updated": "2026-09-04 21:30:24" },
          "sp95":   { "price": 2.49, "updated": "2026-09-04 21:30:24" },
          "sp98":   { "price": 2.57, "updated": "2026-09-04 21:30:24" }
        }
      }
    ]
  }
}

Price board Free

The smallest useful call on the service: one flat object of national petrol and diesel averages plus a server epoch, under 500 bytes. Ideal for a ticker or a widget.

Response (truncated)

{
  "ok": true,
  "ts": 1788814863,
  "petrol": { "AD": 1.616, "AT": 1.889, "DK": 2.392, "ES": 1.823, "FR": 2.166,
              "GB": 1.935, "GR": 2.091, "HR": 1.675, "IS": 1.795, "IT": 2.056, … },
  "diesel": { … }
}

ts is a Unix epoch in seconds — the only endpoint that does not use a date string.

Map layer Pro

A ready-to-drop FeatureCollection for Leaflet, Mapbox or anything else that eats GeoJSON: one point per station, price and opening state in the properties, plus a meta block with the price range in view.

Response (first feature)

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": { "type": "Point", "coordinates": [16.0513559, 46.3896077] },
      "properties": {
        "id": 10075914,
        "name": "West Oil BS Zavrč",
        "brand": "West oil",
        "address": "Zavrč 8c",
        "city": "Zavrč",
        "postal_code": "2283",
        "price": 1.463,
        "fuel": "diesel",
        "is_open": true,
        "updated": "2026-09-07 14:05:51",
        "oh": "Mo-Fr 08:00-18:00; Sa-Su off",
        "open": "closed",
        "next": "08:00"
      }
    }
  ],
  "meta": { "country": "SI", "fuel": "diesel", "returned": 3, "limited": false, … }
}

Pipeline status Free

Station and price counts per market, plus the last twenty ingest runs with row counts and durations. Use it for a health check before you trust a number.

Response (truncated)

{
  "ok": true,
  "data": {
    "station_counts": { "AD": 54, "AT": 2378, "ES": 12417, "FR": 10109, "GB": 8085,
                        "IT": 22423, … },
    "price_counts":   { "AD": 163, "AT": 4227, "ES": 29943, "FR": 35572, … },
    "recent_fetches": [
      {
        "country_code": "AD",
        "source": "govern_ad",
        "fetch_started_at": "2026-09-08 00:07:01",
        "fetch_ended_at":   "2026-09-08 00:07:07",
        "stations_processed": 54,
        "prices_updated": 163,
        "status": "success",
        "execution_time_sec": "6.00"
      }
    ]
  }
}

station_counts lists every market we hold stations for, including ones not yet published in summary (Germany, Sweden). A market appearing here is not a promise that it appears in summary.

Weekly national history Free

Weekly Euro 95 and diesel prices for one country, as three parallel arrays. Source is the European Commission Weekly Oil Bulletin, which is why the series is directly comparable between countries.

Response (ends elided)

{
  "cc": "DE",
  "labels": ["2021-09-13", "2021-09-20", … , "2026-08-31"],
  "e95":    [1.629,        1.636,        … , 2.236],
  "diesel": [1.401,        1.42,         … , 2.232],
  "count":  258
}

The three arrays are index-aligned. A week with no reading for one fuel carries 0, not null — filter those out before you average.

Natural-language query Free

Built for AI agents: ask in English, get structured data back with the intent it parsed, a confidence score and full provenance. Also accepts POST with a batch of questions.

Response (truncated)

{
  "status": "ok",
  "query": "cheapest diesel in Germany",
  "intent": "cheapest_ranking",
  "confidence": 0.95,
  "parsed": { "countries": ["DE"], "fuel_type": "diesel", "time_range_weeks": 12 },
  "metadata": {
    "generated_at": "2026-09-07T21:07:36+00:00",
    "data_date": "2026-08-31",
    "source": "European Commission Weekly Oil Bulletin",
    "currency": "EUR",
    "unit": "per liter, tax-inclusive",
    "update_frequency": "weekly (Thursday after 15:00 EET)"
  },
  "message": "EU countries ranked by diesel price, cheapest first (2026-08-31). #1: Malta.",
  "data": {
    "ranking_top3": [
      { "rank": 1, "country_code": "MT", "country_name": "Malta",  "price_euro95": 1.34,  "price_diesel": 1.21 },
      { "rank": 2, "country_code": "PL", "country_name": "Poland", "price_euro95": 1.525, "price_diesel": 1.669 }
    ]
  }
}

Tolls & barriers Free

Every tolled tunnel, bridge, pass and mainline barrier we track in Europe, with the price in euro and in local currency, plus coordinates. One document, 546 records, cached for a day.

No parameters — you get the whole set (about 210 KB) and filter client-side on country_code or type. Human-readable notes and the licence live at /api/toll/docs.php.

Response (first record)

{
  "count": 546,
  "data": [
    {
      "id": 1445,
      "country_code": "AD",
      "type": "tunnel",
      "barrier_type": "mainline",
      "name": "Tunel d'Envalira",
      "price_eur": 7.9,
      "price_local": 7.9,
      "currency": "EUR",
      "info": "Connects Pas de la Casa (FR border)",
      "lat": 42.545,
      "lng": 1.715
    }
  ]
}