Accueil › Développeurs
API et widget pour les développeurs
Les prix des carburants de Tankeo en JSON, et un widget « carburant le moins cher dans ma ville » à intégrer en une ligne. Gratuit, sans compte : une clé s’obtient par e-mail.
Démarrage rapide
Sans clé, 60 requêtes par heure et par adresse IP pour essayer. Avec une clé gratuite : 60 requêtes par minute et 5 000 par jour.
curl "https://tankeo.fr/api/v1/stations?lat=45.764&lng=4.8357&fuel=diesel&radius=10&limit=5"
curl -H "Authorization: Bearer tk_live_VOTRE_CLE" \
"https://tankeo.fr/api/v1/timeseries?fuel=diesel&days=30"Clé dans Authorization: Bearer … ou X-API-Key. Les appels avec clé acceptent le CORS, mais une clé publiée dans une page web est visible de tous : appelez l’API depuis votre serveur. Description complète : openapi.json (OpenAPI 3.1).
Points d’accès
| Requête | Paramètres (par défaut) |
|---|---|
GET /api/v1/stationsStations with a current price | lat numberlng numbertown stringdepartment codefuel diesel | e10 | sp95 | sp98 | e85 | lpg (diesel)radius integer (10)services listesort price | distance (price)limit integer (20) |
GET /api/v1/stations/{id}One station and its prices | id string, obligatoire |
GET /api/v1/timeseriesDaily average prices | fuel diesel | e10 | sp95 | sp98 | e85 | lpg (diesel)days integer (90)department code |
GET /api/v1/towns/{slug}One town: averages, 7-day change and cheapest stations per fuel | slug string, obligatoire |
GET /api/v1/moversStations whose price moved the most | fuel diesel | e10 | sp95 | sp98 | e85 | lpg (diesel)direction down | up (down)days 1 | 7 | 30 (1)department codelimit integer (20) |
Prévus ensuite : /api/v1/movers (hausses et baisses) et /api/v1/towns/{slug} (page ville).
Réponses, limites et erreurs
Chaque réponse est { "data": …, "meta": { country, generated_at, licence, attribution, … } }. Les en-têtes X-RateLimit-Limit, -Remaining, -Reset (et -Limit-Day, -Remaining-Day) indiquent votre quota ; à l’excès, la réponse est un 429 avec Retry-After. Les erreurs sont { "error": { "code", "message" } } avec un code stable : invalid_parameter, missing_parameter, invalid_api_key, api_key_revoked, not_found, rate_limited, daily_quota_exceeded, anonymous_quota_exceeded, internal_error, unavailable. Les réponses portent un ETag (If-None-Match → 304).
Demander une clé gratuite
Widget à intégrer
Les 3 stations les moins chères d’une ville, la moyenne et la variation sur 7 jours, sans clé. Le lien vers Tankeo fait partie du widget et ne peut pas être retiré. Le script embed.js ajuste automatiquement la hauteur de l’iframe au contenu (plus besoin d’une hauteur fixe devinée à l’avance).
Conditions d’utilisation
- Attribution obligatoire : affichez « Données : Ministère de l'Économie, Licence Ouverte 2.0 » et un lien vers Tankeo (https://tankeo.fr) partout où les données sont montrées.
- Pas de revente des données brutes : vous pouvez bâtir un service avec ces données, mais pas les revendre ni les redistribuer telles quelles (jeu de données, API concurrente). Les données sources restent réutilisables auprès de data.gouv.fr sous Licence Ouverte 2.0.
- Usage raisonnable : respectez les limites, mettez les réponses en cache (elles changent toutes les 15 minutes au plus), n’utilisez pas plusieurs adresses pour contourner les quotas.
- Droit de révocation : nous pouvons limiter, suspendre ou révoquer une clé à tout moment, notamment en cas d’abus. Le service est fourni sans garantie ; les prix sont déclarés par les stations.
- Widget : le lien d’attribution ne doit être ni masqué ni retiré.