API-Dokumentation v1
Aktuelle Kraftstoffpreise (Diesel, Super E5, Super E10) aus den Daten der Markttransparenzstelle für Kraftstoffe (MTS-K).
Maschinenlesbar: OpenAPI 3.1-Spezifikation (JSON)
Authentifizierung
Jede Anfrage benötigt deinen API-Key als Parameter apikey. Den Key findest du in deinem Zugang (nach Freigabe).
Basis-URL: https://kraftstofftanken.de/api.php · nur HTTPS · Antworten JSON.
🧪 API ausprobieren
Kontingent-Stufen & Rate-Limit
| Stufe | Anfragen / Tag |
|---|---|
| free | 10.000 |
| pro | 100.000 |
| partner | 1.000.000 |
Neue Zugänge starten in der Stufe free. Für höhere Kontingente wende dich an uns. Jede authentifizierte Antwort enthält die Header X-RateLimit-Limit und X-RateLimit-Remaining; bei Überschreitung antwortet die API mit 429 und Retry-After.
GET Tankstellen im Umkreis
?action=v1_stations&lat=&lng=&rad=&type=&page=&per_page=&format=&apikey=
| lat, lng | Mittelpunkt (Dezimalgrad), erforderlich |
| rad | Radius in km (1–25, Standard 5) |
| type | all | diesel | e5 | e10 |
| page, per_page | Seitennummer (ab 1) · Treffer pro Seite (1–200, Standard 50) |
| format | optional geojson → FeatureCollection (Content-Type application/geo+json) |
curl "https://kraftstofftanken.de/api.php?action=v1_stations&lat=52.52&lng=13.405&rad=5&type=diesel&apikey=DEIN_KEY"
{
"ok": true, "data": "MTS-K", "page": 1, "per_page": 50, "total": 37,
"stations": [
{ "id": "...", "brand": "Aral", "name": "...", "street": "...", "houseNumber": "12",
"postCode": "10115", "place": "Berlin", "lat": 52.52, "lng": 13.40, "dist": 0.42,
"diesel": 1.719, "e5": 1.829, "e10": 1.769, "isOpen": true }
]
}
Mit &format=geojson als GeoJSON-FeatureCollection (Koordinaten [lng, lat]) – direkt in Leaflet/Mapbox nutzbar.
GET Preise für Stationen
?action=v1_prices&ids=ID1,ID2,…&apikey= (max. 50 IDs)
curl "https://kraftstofftanken.de/api.php?action=v1_prices&ids=ID1,ID2&apikey=DEIN_KEY"
{ "ok": true, "prices": { "ID1": { "status": "open", "diesel": 1.719, "e5": 1.829, "e10": 1.769 } } }
GET Einzelne Station
?action=v1_detail&id=…&apikey=
curl "https://kraftstofftanken.de/api.php?action=v1_detail&id=STATION_ID&apikey=DEIN_KEY"
POST Beschwerde melden
Melde fehlerhafte Preise/Status direkt an die MTS-K (Pflicht zum Beschwerdemanagement). ?action=v1_complaint
| apikey | dein API-Key, erforderlich |
| id | Tankstellen-ID, erforderlich |
| type | wrongPriceE5 | wrongPriceE10 | wrongPriceDiesel | wrongStatusOpen | wrongStatusClosed | wrongPetrolStationLocation |
| content | bei Preisbeschwerden korrigierter Preis (z. B. 1.719); bei Standort lat,lng |
curl -X POST "https://kraftstofftanken.de/api.php?action=v1_complaint" \ -d "apikey=DEIN_KEY&id=STATION_ID&type=wrongPriceDiesel&content=1.719"
{ "ok": true, "message": "Beschwerde entgegengenommen und zur Weiterleitung an die MTS-K eingereiht." }
Erfolg: HTTP 202 Accepted. Die Beschwerde wird gesammelt und an die MTS-K übermittelt.
Fehlercodes
| 202 | Beschwerde entgegengenommen |
| 400 | Ungültige Parameter (z. B. Beschwerdetyp) |
| 403 | API-Key ungültig, nicht freigegeben oder deaktiviert |
| 429 | Tageslimit erreicht (siehe Retry-After) |
| ok:false | Fehlermeldung im Feld message |
Bitte nenne bei Nutzung die Datenquelle „Markttransparenzstelle für Kraftstoffe (MTS-K)". Preisfehler bitte über dein Beschwerdemanagement (Endpunkt oben) melden.