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
Ontwikkelaars
MaPompe API
Integreer tankstations en brandstofprijzen van MaPompe in een applicatie, website of dienst.
01 · AAN DE SLAG
Basis-URL
https://mapompe.com/api/v1
De commerciële API gebruikt authenticatie met een API-sleutel. Aanroepen zijn bedoeld voor server-naar-servergebruik.
Belangrijk:
Het endpoint /api/stations dat door de openbare MaPompe-site wordt gebruikt, is een interne API. Het maakt geen deel uit van de commerciële API en de toegang is beveiligd.
02 · AUTHENTICATIE
API-sleutel
Maak een sleutel aan via Mijn account → Ontwikkelaars-API. De volledige sleutel wordt slechts één keer getoond.
X-API-Key: mp_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Het Bearer-schema wordt ook ondersteund:
Authorization: Bearer mp_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Plaats nooit een API-sleutel in JavaScript dat naar de browser wordt gestuurd, in een onbeveiligde mobiele app of in een openbare Git-repository.
03 · ENDPOINT
Tankstations rond een punt
/api/v1/stations
Geeft de dichtstbijzijnde actieve tankstations terug, gesorteerd op prijs en daarna afstand.
| Parameter | Type | Verplicht | Beschrijving |
|---|---|---|---|
lat |
number | Ja | Latitude du centre. |
lng |
number | Ja | Longitude du centre. |
radius |
number | Nee | Rayon en kilomètres selon le plan. |
fuel |
string | Nee | gazole, e10, sp95, sp98, e85 ou gplc. |
limit |
integer | Nee | 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
Tankstation zoeken
/api/v1/search
Zoek op naam, merk, adres, stad, postcode of de door Google weergegeven naam.
| Parameter | Type | Verplicht | Beschrijving |
|---|---|---|---|
q |
string | Ja | 3 à 80 caractères. |
limit |
integer | Nee | 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
Prijsgeschiedenis
/api/v1/stations/{station_id}/history
Geeft de prijsontwikkeling van een brandstof bij een tankstation terug. De beschikbare geschiedenis hangt af van het abonnement.
| Parameter | Type | Verplicht | Beschrijving |
|---|---|---|---|
station_id |
integer | Ja | Identifiant de la station dans MaPompe. |
fuel |
string | Nee | Carburant demandé. |
days |
integer | Nee | 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 · ABONNEMENTEN
Abonnementen en limieten
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
Bescherming tegen massaal gebruik:
Maandelijkse, dagelijkse en minuutquota zijn cumulatief. Meerdere sleutels van hetzelfde account delen hetzelfde quota. De API biedt geen bulkexport van de database.
07 · FOUTEN
HTTP-codes
| Code | Fout | Betekenis |
|---|---|---|
200 |
OK | Verzoek verwerkt. |
400 |
Paramètres invalides | Een parameter ontbreekt, is ongeldig of valt buiten de limieten. |
401 |
Clé invalide | Sleutel ontbreekt, is onjuist of ingetrokken. |
404 |
Not found | Tankstation bestaat niet of is inactief. |
429 |
Limite atteinte | Maandelijkse, dagelijkse of minuutlimiet overschreden. |
500 |
Server error | Interne servicefout. |
{
"error": "quota_exceeded",
"message": "Quota mensuel atteint.",
"limit": 1000,
"used": 1000,
"reset_at": "2026-10-01T00:00:00Z",
"retry_after": 518400
}
BESTE PRAKTIJKEN
De API correct gebruiken
Cache
Cache resultaten aan serverzijde wanneer dat nuttig is. Het is niet nodig hetzelfde gebied binnen korte tijd meerdere keren op te vragen.
Privésleutel
Bewaar de sleutel in een omgevingsvariabele of secretmanager. Zet hem nooit in Git.
Limieten respecteren
Gebruik de headers X-RateLimit-Remaining en X-Quota-Remaining om uw integratie te sturen.
Geen scraping
De API is bedoeld voor applicatie-integratie en niet om een kopie van de MaPompe-database te maken.