Prices · Fuel

Fuel price widget

The price at the stations you actually drive past, on your Android home screen — from the official German market data via Tankerkönig.

Get the app How it works

Preview · sample data

The source

Fuel prices move several times a day and the nearest station is not always the cheapest. Two lines are enough to compare them before you turn the key, instead of opening a price app at the pump.

creativecommons.tankerkoenig.de

https://creativecommons.tankerkoenig.de/json/list.php?lat=52.521&lng=13.438&rad=1.5&type=all&apikey=YOUR-KEY

The result format

Pick the fields you want by their JSON path, and embed them between braces. A literal \n breaks the line; everything else is copied as written.

Response: https://creativecommons.tankerkoenig.de/json/list.php?lat=52.521&lng=13.438&rad=1.5&type=all&apikey=YOUR-KEY

#each stations(2)\n{brand}|{diesel} €\n#end

HEM2.20 €ARAL2.55 €

Every rule this language supports — paths, indexes, math, optional values, lists — is in the mapping docs.

At a glance

Diesel, E5 or E10 at the two stations near you, price side by side.

Two rows, not a list

stations(2) is a row limiter: it keeps the first two entries the API returned, so the widget stays readable instead of scrolling.

One request, every fuel

The response carries diesel, e5 and e10 side by side, so swapping {diesel} for {e5} or {e10} costs no extra request.

Sorting follows distance

With type=all the API always sorts by distance. sort=price only applies when you ask for a single fuel type.

Do not hammer the key

Requests are limited and keys get blocked. One tracker per radius, every five minutes, is the intended use.

Tankerkönig needs a free API key, and the data is CC BY 4.0 — credit tankerkoenig.de wherever you publish it. Their terms ask for at most one request per minute, so a five-minute widget interval is the right shape. type=all returns diesel, e5 and e10 for every station in one call.

Keep reading

All use cases

Gold price widget The live XAU rate on your home screen, formatted the way you read it.Website monitor widget The health of your endpoint, or the last check from your uptime provider. The widget on your home screen Pinning, resizing, refresh intervals and what the error marker means.