Startseite / API

Eine API.
Öffentliche Preise.

Die TankPuls-API gibt die offiziell gemeldeten Kraftstoffpreise aller bundesweit registrierten Tankstellen weiter — als schlankes JSON, ohne Umwege, ohne Registrierungszwang für nichtkommerzielle Nutzung.

A1 Entwickler-Referenz v1.0 · Stand 21.04.2026

Überblick

Die TankPuls-API ist eine REST-API mit stabilen, versionierten Pfaden. Alle Antworten sind application/json, UTF-8 kodiert, und folgen strikt dem unten dokumentierten Schema. Preise stammen ausschließlich aus der Markttransparenzstelle für Kraftstoffe (MTS-K) beim Bundeskartellamt.

Basis-URL https://api.tankpuls.de/v1

Der Dienst ist kostenfrei für persönliche, journalistische und wissenschaftliche Zwecke. Kommerzielle Nutzung ist nach vorheriger Anmeldung unter api@tankpuls.de möglich.

Authentifizierung

Alle öffentlichen Lese-Endpunkte sind ohne API-Schlüssel erreichbar, solange die Rate-Limits für anonyme Zugriffe ausreichen (60 Anfragen / Minute). Für höhere Limits fordern Sie unter api@tankpuls.de einen Schlüssel an. Dieser wird per Authorization-Header übergeben: 

GET /v1/stations?lat=52.5200&lon=13.4050
Authorization: Bearer tp_live_••••••••••••
Accept:        application/json

Endpunkte

Fünf öffentliche Endpunkte — mehr nicht nötig.

GET /v1/stations
Tankstellen im angegebenen Umkreis, sortiert nach Preis oder Entfernung.
lat, lonnumberGeokoordinaten des Zentrums (WGS84). radiusnumberRadius in Kilometern · Standard 5, max. 25. fuelenumE5 · E10 · Diesel · Standard E10. sortenumprice · distance · Standard price.
GET /v1/stations/{id}
Einzelne Station mit aktuellen Preisen, Öffnungszeiten und Metadaten.
iduuidDie MTS-K-Stations-ID.
GET /v1/stations/{id}/history
Preisverlauf einer Station über einen gewählten Zeitraum.
rangeenum24h · 7d · 30d · 90d · 1y · Standard 24h. fuelenumE5 · E10 · Diesel.
GET /v1/regions/{plz}/summary
Regionaler Median, Spannweite und Aktualisierungszähler je PLZ-Gebiet.
plzstringFünfstellige deutsche Postleitzahl. fuelenumE5 · E10 · Diesel.
GET /v1/health
Status der MTS-K-Anbindung, aktuelle Latenz und letzter Meldungszeitpunkt.

Antwortformat

Beispielantwort für /v1/stations?lat=52.5200&lon=13.4050&fuel=E5:

{
  "updated_at": "2026-04-21T09:01:03Z",
  "source":     "mts-k",
  "region":     { "plz": "10559", "median": 2.079 },
  "stations": [
    {
      "id":       "b1e4…f2",
      "brand":    "Westfehling Tankstelle",
      "address":  "Quitzowstraße 33, 10559 Berlin",
      "distance": 5.3,
      "prices":   { "e5": 2.039, "e10": 1.979, "diesel": 2.039 },
      "signal":   "low",
      "open":     true,
      "reported_at": "2026-04-21T09:00:48Z"
    }
  ]
}

Signalwerte

signalBedeutungRegel
lowGünstigunter dem 24-h-Median der Region
avgDurchschnittlichinnerhalb des Normalbereichs
highTeurerbis +5 ct über dem Median
xhighAußergewöhnlich teuermehr als +5 ct über dem Median

Rate-Limits

ZugriffAnfragen / MinuteAnfragen / Tag
Anonym6010.000
Privat-Key30050.000
Kommerziellauf Anfrageauf Anfrage

Antworten enthalten die Header X-RateLimit-Remaining und X-RateLimit-Reset. Überschreitungen ergeben 429 Too Many Requests.

Lizenz & Namensnennung

Die ausgelieferten Preisdaten stammen aus der MTS-K und unterliegen deren Nutzungsbedingungen. Für alle nicht-kommerziellen Anwendungen gilt: bitte nennen Sie als Quelle „TankPuls · MTS-K", idealerweise mit Link auf tankpuls.de.

Eine Weiterveräußerung der Rohdaten ist nicht gestattet. Abgeleitete, aggregierte Auswertungen dürfen frei veröffentlicht werden.

Changelog

VersionDatumÄnderung
1.0.021.04.2026Öffentlicher Start. Fünf Endpunkte, stabile URL-Struktur.
0.9.204.04.2026Regionaler Median & Signalwerte eingeführt.
0.9.017.03.2026Beta mit ausgewählten Partnern.