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
Développeurs
API MaPompe
Intègre les stations et les prix des carburants MaPompe dans une application, un site ou un service.
01 · DéMARRAGE
URL de base
https://mapompe.com/api/v1
L’API commerciale utilise une authentification par clé API. Les appels sont prévus pour une consommation serveur-à-serveur.
Important :
L’endpoint /api/stations utilisé par le site public MaPompe est une API interne de fonctionnement. Il ne fait pas partie de l’API commerciale et son accès est protégé.
02 · AUTHENTIFICATION
Clé API
Crée une clé depuis Mon compte → API développeur. La clé complète n’est affichée qu’une seule fois.
X-API-Key: mp_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Le schéma Bearer est également accepté :
Authorization: Bearer mp_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Ne place jamais une clé API dans le JavaScript distribué au navigateur, dans une application mobile non protégée ou dans un dépôt Git public.
03 · ENDPOINT
Stations autour d’un point
/api/v1/stations
Retourne les stations actives les plus proches, triées par prix puis distance.
| Paramètre | Type | Requis | Description |
|---|---|---|---|
lat |
number | Oui | Latitude du centre. |
lng |
number | Oui | Longitude du centre. |
radius |
number | Non | Rayon en kilomètres selon le plan. |
fuel |
string | Non | gazole, e10, sp95, sp98, e85 ou gplc. |
limit |
integer | Non | 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
Recherche de stations
/api/v1/search
Recherche par nom, marque, adresse, ville, code postal ou nom affiché Google.
| Paramètre | Type | Requis | Description |
|---|---|---|---|
q |
string | Oui | 3 à 80 caractères. |
limit |
integer | Non | 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
Historique des prix
/api/v1/stations/{station_id}/history
Retourne l’évolution du prix d’un carburant sur une station. La profondeur disponible dépend du plan.
| Paramètre | Type | Requis | Description |
|---|---|---|---|
station_id |
integer | Oui | Identifiant de la station dans MaPompe. |
fuel |
string | Non | Carburant demandé. |
days |
integer | Non | 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 · OFFRES
Plans et limites
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
Anti-usage massif :
Les quotas mensuels, journaliers et par minute sont cumulatifs. Plusieurs clés appartenant au même compte partagent le même quota. Aucun export massif de la base n’est fourni par l’API.
07 · ERREURS
Codes HTTP
| Code | Erreur | Signification |
|---|---|---|
200 |
OK | Requête traitée. |
400 |
Paramètres invalides | Un paramètre est absent, invalide ou hors limite. |
401 |
Clé invalide | Clé absente, incorrecte ou révoquée. |
404 |
Not found | Station inexistante ou inactive. |
429 |
Limite atteinte | Quota mensuel, journalier ou limite par minute dépassée. |
500 |
Server error | Erreur interne du service. |
{
"error": "quota_exceeded",
"message": "Quota mensuel atteint.",
"limit": 1000,
"used": 1000,
"reset_at": "2026-10-01T00:00:00Z",
"retry_after": 518400
}
BONNES PRATIQUES
Utiliser l’API proprement
Cache
Mets en cache les résultats côté serveur lorsque c’est pertinent. Il est inutile de redemander plusieurs fois la même zone dans une courte période.
Clé privée
Garde la clé dans une variable d’environnement ou un gestionnaire de secrets. Ne la committe jamais dans Git.
Respect des limites
Utilise les en-têtes X-RateLimit-Remaining et X-Quota-Remaining pour piloter ton intégration.
Pas de scraping
L’API est destinée à une intégration applicative et non à la constitution d’une copie de la base MaPompe.