Free
0 €
- 1 000 requêtes / mois
- 100 requêtes / jour
- 5 requêtes / minute
- Rayon 10 km
- 25 résultats / requête
- Historique 14 jours
- 1 clé active
Entwickler
MaPompe API
Integrieren Sie MaPompe-Tankstellen und Kraftstoffpreise in eine Anwendung, Website oder einen Dienst.
01 · ERSTE SCHRITTE
Basis-URL
https://mapompe.com/api/v1
Die kommerzielle API verwendet eine Authentifizierung per API-Schlüssel. Die Aufrufe sind für Server-zu-Server-Nutzung vorgesehen.
Wichtig:
Der vom öffentlichen MaPompe-Webauftritt verwendete Endpoint /api/stations ist eine interne API. Er gehört nicht zur kommerziellen API und der Zugriff ist geschützt.
02 · AUTHENTIFIZIERUNG
API-Schlüssel
Erstellen Sie einen Schlüssel unter Mein Konto → Entwickler-API. Der vollständige Schlüssel wird nur einmal angezeigt.
X-API-Key: mp_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Auch das Bearer-Schema wird akzeptiert:
Authorization: Bearer mp_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Platzieren Sie niemals einen API-Schlüssel in an den Browser ausgeliefertem JavaScript, einer ungeschützten mobilen App oder einem öffentlichen Git-Repository.
03 · ENDPOINT
Tankstellen rund um einen Punkt
/api/v1/stations
Liefert die nächstgelegenen aktiven Tankstellen, sortiert nach Preis und anschließend Entfernung.
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
lat |
number | Ja | Latitude du centre. |
lng |
number | Ja | Longitude du centre. |
radius |
number | Nein | Rayon en kilomètres selon le plan. |
fuel |
string | Nein | gazole, e10, sp95, sp98, e85 ou gplc. |
limit |
integer | Nein | Nombre maximal de stations selon le plan. |
curl -H "X-API-Key: mp_live_xxx" \
"https://mapompe.com/api/v1/stations?lat=43.3442&lng=3.2150&radius=10&fuel=gazole&limit=25"
{
"data": [
{
"id": 123,
"country": "FR",
"slug": "station-exemple",
"name": "Station Exemple",
"brand": "TotalEnergies",
"address": "10 rue Exemple",
"city": "Béziers",
"postcode": "34500",
"latitude": 43.3442,
"longitude": 3.2150,
"price_eur": 1.749,
"observed_at": "2026-09-24 12:00:00",
"distance_km": 1.42,
"price_quality": "official",
"station_url": "https://mapompe.com/station/FR/station-exemple"
}
],
"meta": {
"count": 1,
"fuel": "gazole",
"latitude": 43.3442,
"longitude": 3.2150,
"radius_km": 10,
"limit": 25,
"plan": "free",
"plan_name": "Free"
}
}
04 · ENDPOINT
Tankstellensuche
/api/v1/search
Suche nach Name, Marke, Adresse, Stadt, Postleitzahl oder von Google angezeigtem Namen.
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
q |
string | Ja | 3 à 80 caractères. |
limit |
integer | Nein | Nombre maximal de résultats selon le plan. |
curl -H "X-API-Key: mp_live_xxx" \
"https://mapompe.com/api/v1/search?q=Béziers&limit=10"
{
"data": [
{
"id": 123,
"country": "FR",
"slug": "station-exemple",
"name": "Station Exemple",
"brand": "TotalEnergies",
"city": "Béziers",
"postcode": "34500",
"latitude": 43.3442,
"longitude": 3.215,
"hours": null,
"services": [],
"updated_at": "2026-09-24 12:00:00",
"station_url": "https://mapompe.com/station/FR/station-exemple"
}
],
"meta": {
"count": 1,
"query": "Béziers",
"limit": 10,
"plan": "free",
"plan_name": "Free"
}
}
05 · ENDPOINT
Preisverlauf
/api/v1/stations/{station_id}/history
Liefert die Preisentwicklung eines Kraftstoffs an einer Tankstelle. Die verfügbare Historie hängt vom Tarif ab.
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
station_id |
integer | Ja | Identifiant de la station dans MaPompe. |
fuel |
string | Nein | Carburant demandé. |
days |
integer | Nein | Nombre de jours selon le plan. |
curl -H "X-API-Key: mp_live_xxx" \
"https://mapompe.com/api/v1/stations/123/history?fuel=gazole&days=14"
{
"data": [
{
"price_eur": 1.749,
"observed_at": "2026-09-24 12:00:00"
},
{
"price_eur": 1.739,
"observed_at": "2026-09-23 12:00:00"
}
],
"meta": {
"station_id": 123,
"fuel": "gazole",
"days": 14,
"count": 2,
"plan": "free",
"plan_name": "Free"
}
}
06 · TARIFE
Tarife und Limits
Starter
19 € / mois
- 25 000 requêtes / mois
- 2 000 requêtes / jour
- 20 requêtes / minute
- Rayon 25 km
- 50 résultats / requête
- Historique 30 jours
- 3 clés actives
Pro
59 € / mois
- 150 000 requêtes / mois
- 10 000 requêtes / jour
- 60 requêtes / minute
- Rayon 50 km
- 100 résultats / requête
- Historique 90 jours
- 5 clés actives
Business
149 € / mois
- 500 000 requêtes / mois
- 30 000 requêtes / jour
- 120 requêtes / minute
- Rayon 100 km
- 150 résultats / requête
- Historique 180 jours
- 10 clés actives
Schutz vor Massennutzung:
Monatliche, tägliche und minütliche Kontingente sind kumulativ. Mehrere Schlüssel desselben Kontos teilen sich dasselbe Kontingent. Die API bietet keinen Massenexport der Datenbank.
07 · FEHLER
HTTP-Codes
| Code | Fehler | Bedeutung |
|---|---|---|
200 |
OK | Anfrage verarbeitet. |
400 |
Paramètres invalides | Ein Parameter fehlt, ist ungültig oder außerhalb des zulässigen Bereichs. |
401 |
Clé invalide | Schlüssel fehlt, ist falsch oder widerrufen. |
404 |
Not found | Tankstelle existiert nicht oder ist inaktiv. |
429 |
Limite atteinte | Monatliches, tägliches oder minütliches Limit überschritten. |
500 |
Server error | Interner Dienstfehler. |
{
"error": "quota_exceeded",
"message": "Quota mensuel atteint.",
"limit": 1000,
"used": 1000,
"reset_at": "2026-10-01T00:00:00Z",
"retry_after": 518400
}
BEST PRACTICES
API richtig verwenden
Cache
Speichern Sie Ergebnisse bei Bedarf serverseitig zwischen. Es ist nicht nötig, dasselbe Gebiet innerhalb kurzer Zeit mehrfach abzufragen.
Privater Schlüssel
Bewahren Sie den Schlüssel in einer Umgebungsvariable oder einem Secret-Manager auf. Niemals in Git committen.
Limits beachten
Verwenden Sie die Header X-RateLimit-Remaining und X-Quota-Remaining zur Steuerung Ihrer Integration.
Kein Scraping
Die API ist für die Anwendungsintegration gedacht, nicht zum Erstellen einer Kopie der MaPompe-Datenbank.