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
Desarrolladores
API de MaPompe
Integra las gasolineras y los precios de combustible de MaPompe en una aplicación, sitio web o servicio.
01 · PRIMEROS PASOS
URL base
https://mapompe.com/api/v1
La API comercial utiliza autenticación mediante clave API. Las llamadas están pensadas para un uso servidor a servidor.
Importante:
El endpoint /api/stations utilizado por el sitio público de MaPompe es una API interna. No forma parte de la API comercial y su acceso está protegido.
02 · AUTENTICACIóN
Clave API
Crea una clave desde Mi cuenta → API de desarrolladores. La clave completa solo se muestra una vez.
X-API-Key: mp_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
También se acepta el esquema Bearer:
Authorization: Bearer mp_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
No coloques nunca una clave API en JavaScript distribuido al navegador, una aplicación móvil sin protección o un repositorio Git público.
03 · ENDPOINT
Gasolineras alrededor de un punto
/api/v1/stations
Devuelve las gasolineras activas más cercanas, ordenadas por precio y después por distancia.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
lat |
number | Sí | Latitude du centre. |
lng |
number | Sí | Longitude du centre. |
radius |
number | No | Rayon en kilomètres selon le plan. |
fuel |
string | No | gazole, e10, sp95, sp98, e85 ou gplc. |
limit |
integer | No | 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
Búsqueda de gasolineras
/api/v1/search
Busca por nombre, marca, dirección, ciudad, código postal o nombre mostrado por Google.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
q |
string | Sí | 3 à 80 caractères. |
limit |
integer | No | 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
Historial de precios
/api/v1/stations/{station_id}/history
Devuelve la evolución del precio de un combustible en una gasolinera. El historial disponible depende del plan.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
station_id |
integer | Sí | Identifiant de la station dans MaPompe. |
fuel |
string | No | Carburant demandé. |
days |
integer | No | 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 · PLANES
Planes y límites
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
Protección contra uso masivo:
Las cuotas mensuales, diarias y por minuto son acumulativas. Varias claves del mismo cuenta comparten la misma cuota. La API no proporciona exportaciones masivas de la base de datos.
07 · ERRORES
Códigos HTTP
| Code | Error | Significado |
|---|---|---|
200 |
OK | Solicitud procesada. |
400 |
Paramètres invalides | Falta un parámetro, no es válido o está fuera de los límites. |
401 |
Clé invalide | Clave ausente, incorrecta o revocada. |
404 |
Not found | La gasolinera no existe o está inactiva. |
429 |
Limite atteinte | Se ha superado el límite mensual, diario o por minuto. |
500 |
Server error | Error interno del servicio. |
{
"error": "quota_exceeded",
"message": "Quota mensuel atteint.",
"limit": 1000,
"used": 1000,
"reset_at": "2026-10-01T00:00:00Z",
"retry_after": 518400
}
BUENAS PRÁCTICAS
Usar la API correctamente
Caché
Almacena en caché los resultados en el servidor cuando sea apropiado. No es necesario solicitar varias veces la misma zona en un periodo corto.
Clave privada
Guarda la clave en una variable de entorno o gestor de secretos. No la subas nunca a Git.
Respetar los límites
Utiliza las cabeceras X-RateLimit-Remaining y X-Quota-Remaining para controlar tu integración.
Sin scraping
La API está destinada a integraciones de aplicaciones y no a crear una copia de la base de datos de MaPompe.