Stations carburant de l'API Floweet : prix et services

Sur cette page

À savoir
Source et reprise
L'objet FuelStation
L'objet FuelPrice
L'objet CheapestStations
L'objet FuelStationDetail
Liste des stations-service, filtrée et triée par nom
Les 10 stations les moins chères d'un département pour le gazole
Une station-service : enseigne, prix, carburants, services, horaires

Les stations-service de France et des autres marchés suivis par Floweet (Allemagne, Espagne, Italie) : enseigne, adresse, carburants vendus et dernier prix de chacun, services, horaires et accès poids lourds. Une troisième opération donne, pour un département français, les dix stations où le gazole est le moins cher.

À savoir

prices est un dictionnaire par code carburant (B7, SP95_E10, SP98, E85, GPL…) : chaque entrée porte son prix en millièmes d'euro par litre et sa date de mise à jour. Vérifiez updatedAt : une station qui ne publie plus garde son dernier prix connu.
Les moins chères d'un département : gazole (B7) seulement, prix de moins de 7 jours, stations d'autoroute comprises et signalées par highway. Filtrez-les de votre côté si vous comparez des stations de ville.
brand est l'enseigne canonique, la même que dans le baromètre ; null quand aucune enseigne n'est reconnue.
La liste et la fiche d'une station demandent le module Stations dans l'offre de l'organisation ; sinon, 403 plan_required (voir offres et IA).

Source et reprise

France : prix-carburants.gouv.fr (Licence Ouverte 2.0). Les prix publiés sont ceux affichés à la pompe, hors remises et frais de carte.

L'objet FuelStation

Champ	Type	Description
`id`toujours présent	`string (uuid)`
`name`toujours présent	`string`
`brand`toujours présent	`string \| null`
`city`toujours présent	`string \| null`
`postalCode`toujours présent	`string \| null`
`country`toujours présent	`string`
`fuels`toujours présent	`string[]`
`services`toujours présent	`string[]`
`open24h`toujours présent	`boolean`
`prices`toujours présent	`{ [code]: FuelPrice }`	Dernier prix par code carburant.

FuelStation

{
  "id": "28898708-4170-48bb-a3f5-e9b0d5d7ee53",
  "name": "Carrefour",
  "brand": "Carrefour",
  "city": "Rambouillet",
  "postalCode": "78120",
  "country": "FR",
  "fuels": [
    "B7",
    "GPL",
    "SP95",
    "SP95_E10",
    "SP98"
  ],
  "services": [],
  "open24h": true,
  "prices": {
    "B7": {
      "price": 2409,
      "updatedAt": "2026-10-24T20:51:00+00:00"
    },
    "GPL": {
      "price": 1102,
      "updatedAt": "2026-10-24T20:51:00+00:00"
    },
    "SP95": {
      "price": 2159,
      "updatedAt": "2026-10-24T20:51:00+00:00"
    },
    "SP98": {
      "price": 2225,
      "updatedAt": "2026-10-24T20:51:00+00:00"
    },
    "SP95_E10": {
      "price": 2119,
      "updatedAt": "2026-10-24T20:51:00+00:00"
    }
  }
}

L'objet FuelPrice

Champ	Type	Description
`price`toujours présent	`integer`	Prix en millièmes d'euro par litre (2372 = 2,372 €/L).
`updatedAt`toujours présent	`string (date-time) \| null`

FuelPrice

{
  "price": 2409,
  "updatedAt": "2026-10-24T20:51:00+00:00"
}

L'objet CheapestStations

Les 10 stations les moins chères du département pour le gazole (B7), prix de moins de 7 jours.

Champ	Type	Description
`results`toujours présent	`object[]`
`results[].id`toujours présent	`string`
`results[].name`toujours présent	`string`
`results[].address`toujours présent	`string`
`results[].city`toujours présent	`string \| null`
`results[].brand`toujours présent	`string`
`results[].price`toujours présent	`integer`	Prix en millièmes d'euro par litre (2372 = 2,372 €/L).
`results[].highway`toujours présent	`boolean`
`results[].updatedAt`toujours présent	`string (date-time)`

CheapestStations

{
  "results": [
    {
      "id": "1852fb61-66f7-4ac0-b4a9-06efc51f883b",
      "name": "Total",
      "address": "RD.191",
      "city": "Beynes",
      "brand": "TotalEnergies",
      "price": 2225,
      "highway": false,
      "updatedAt": "2026-10-23T08:57:14+00:00"
    },
    {
      "id": "e7bb4a93-8afb-4ee3-af40-3d68ce746be7",
      "name": "MORAINVILLIERS",
      "address": "AUTOROUTE A13 - AIRE DE MORAINVILLIERS SUD",
      "city": "MORAINVILLIERS",
      "brand": "Indépendants et autres",
      "price": 2250,
      "highway": true,
      "updatedAt": "2026-10-25T23:01:00+00:00"
    },
    {
      "id": "0531352a-266d-4207-9da1-50b577aebe86",
      "name": "Relais de Guyancourt",
      "address": "10 AV DE L'EUROPE",
      "city": "Guyancourt",
      "brand": "TotalEnergies",
      "price": 2250,
      "highway": false,
      "updatedAt": "2026-10-25T23:01:00+00:00"
    }
  ]
}

L'objet FuelStationDetail

Champ	Type	Description
`id`toujours présent	`string (uuid)`
`name`toujours présent	`string`
`brand`toujours présent	`string \| null`
`city`toujours présent	`string \| null`
`postalCode`toujours présent	`string \| null`
`country`toujours présent	`string`
`fuels`toujours présent	`string[]`
`services`toujours présent	`string[]`
`open24h`toujours présent	`boolean`
`prices`toujours présent	`{ [code]: FuelPrice }`	Dernier prix par code carburant.
`address`toujours présent	`string \| null`
`location`toujours présent	`object`
`location.lat`toujours présent	`number`
`location.lng`toujours présent	`number`
`heavyVehicleAccess`toujours présent	`boolean`
`openingHours`facultatif	`any`	Horaires déclarés dans le flux officiel (days, always_open).

FuelStationDetail

{
  "id": "28898708-4170-48bb-a3f5-e9b0d5d7ee53",
  "name": "Carrefour",
  "brand": "Carrefour",
  "city": "Rambouillet",
  "postalCode": "78120",
  "country": "FR",
  "fuels": [
    "B7",
    "GPL",
    "SP95",
    "SP95_E10",
    "SP98"
  ],
  "services": [],
  "open24h": true,
  "prices": {
    "B7": {
      "price": 2409,
      "updatedAt": "2026-10-24T20:51:00+00:00"
    },
    "GPL": {
      "price": 1102,
      "updatedAt": "2026-10-24T20:51:00+00:00"
    },
    "SP95": {
      "price": 2159,
      "updatedAt": "2026-10-24T20:51:00+00:00"
    },
    "SP98": {
      "price": 2225,
      "updatedAt": "2026-10-24T20:51:00+00:00"
    },
    "SP95_E10": {
      "price": 2119,
      "updatedAt": "2026-10-24T20:51:00+00:00"
    }
  },
  "address": "RN10 CENTRE COMMERCIAL DU BEL AIR",
  "location": {
    "lat": 48.6250208716154,
    "lng": 1.82953830436914
  },
  "heavyVehicleAccess": false,
  "openingHours": {}
}

Liste des stations-service, filtrée et triée par nom

GET/v1/fuel-stationsScope fuel-stations:read

Paramètres

Champ	Où	Type	Description
`limit`facultatif	requête	`integer`de 1 à 100 · défaut 20	Nombre d'éléments par page (1 à 100, 20 par défaut).
`cursor`facultatif	requête	`string`au plus 400 caractères	Curseur opaque : la valeur `nextCursor` de la page précédente.
`q`facultatif	requête	`string`au plus 100 caractères	Nom ou ville (contient).
`fuels`facultatif	requête	`string`	Codes carburant séparés par des virgules (B7, SP95_E10, SP98, E85, GPL, GNV…).
`services`facultatif	requête	`string`	Codes service séparés par des virgules.
`open24h`facultatif	requête	`string`	true : ouvertes 24 h/24 seulement.
`country`facultatif	requête	`string`	Code pays ISO 3166-1 alpha-2 (FR, DE, ES, IT). Absent : tous les pays.

Réponse 200

Succès — Une page de FuelStation { data, nextCursor, hasMore }

Erreurs

HTTP	Signification
`400`	Requête invalide
`401`	Clé d'API absente, invalide ou révoquée
`403`	Accès refusé (scope, plan ou statut du compte)
`404`	Ressource introuvable
`429`	Trop de requêtes
`500`	Erreur interne

Requête

curl "https://api.floweet.com/v1/fuel-stations?fuels=B7%2CE85&country=FR" \
  -H "Authorization: Bearer $FLOWEET_API_KEY"

Réponse 200

{
  "data": [
    {
      "id": "28898708-4170-48bb-a3f5-e9b0d5d7ee53",
      "name": "Carrefour",
      "brand": "Carrefour",
      "city": "Rambouillet",
      "postalCode": "78120",
      "country": "FR",
      "fuels": [
        "B7",
        "GPL",
        "SP95",
        "SP95_E10",
        "SP98"
      ],
      "services": [],
      "open24h": true,
      "prices": {
        "B7": {
          "price": 2409,
          "updatedAt": "2026-10-24T20:51:00+00:00"
        },
        "GPL": {
          "price": 1102,
          "updatedAt": "2026-10-24T20:51:00+00:00"
        },
        "SP95": {
          "price": 2159,
          "updatedAt": "2026-10-24T20:51:00+00:00"
        },
        "SP98": {
          "price": 2225,
          "updatedAt": "2026-10-24T20:51:00+00:00"
        },
        "SP95_E10": {
          "price": 2119,
          "updatedAt": "2026-10-24T20:51:00+00:00"
        }
      }
    }
  ],
  "nextCursor": "eyJwIjoyLCJzIjoxfQ",
  "hasMore": true
}

Les 10 stations les moins chères d'un département pour le gazole

GET/v1/fuel-stations/cheapestScope fuel-stations:read

Paramètres

Champ	Où	Type	Description
`department`obligatoire	requête	`string`	Code du département (01 à 95, 2A, 2B).

Réponse 200

Succès — Un objet CheapestStations

Erreurs

HTTP	Signification
`400`	Requête invalide
`401`	Clé d'API absente, invalide ou révoquée
`403`	Accès refusé (scope, plan ou statut du compte)
`404`	Ressource introuvable
`429`	Trop de requêtes
`500`	Erreur interne

Requête

curl "https://api.floweet.com/v1/fuel-stations/cheapest?department=78" \
  -H "Authorization: Bearer $FLOWEET_API_KEY"

Réponse 200

{
  "results": [
    {
      "id": "1852fb61-66f7-4ac0-b4a9-06efc51f883b",
      "name": "Total",
      "address": "RD.191",
      "city": "Beynes",
      "brand": "TotalEnergies",
      "price": 2225,
      "highway": false,
      "updatedAt": "2026-10-23T08:57:14+00:00"
    },
    {
      "id": "e7bb4a93-8afb-4ee3-af40-3d68ce746be7",
      "name": "MORAINVILLIERS",
      "address": "AUTOROUTE A13 - AIRE DE MORAINVILLIERS SUD",
      "city": "MORAINVILLIERS",
      "brand": "Indépendants et autres",
      "price": 2250,
      "highway": true,
      "updatedAt": "2026-10-25T23:01:00+00:00"
    },
    {
      "id": "0531352a-266d-4207-9da1-50b577aebe86",
      "name": "Relais de Guyancourt",
      "address": "10 AV DE L'EUROPE",
      "city": "Guyancourt",
      "brand": "TotalEnergies",
      "price": 2250,
      "highway": false,
      "updatedAt": "2026-10-25T23:01:00+00:00"
    }
  ]
}

Une station-service : enseigne, prix, carburants, services, horaires

GET/v1/fuel-stations/{id}Scope fuel-stations:read

Paramètres

Champ	Où	Type	Description
`id`obligatoire	chemin	`string (uuid)`

Réponse 200

Succès — Un objet FuelStationDetail

Erreurs

HTTP	Signification
`400`	Requête invalide
`401`	Clé d'API absente, invalide ou révoquée
`403`	Accès refusé (scope, plan ou statut du compte)
`404`	Ressource introuvable
`429`	Trop de requêtes
`500`	Erreur interne

Requête

curl "https://api.floweet.com/v1/fuel-stations/7d0c1f8e-2a4b-4c6d-9e8f-0a1b2c3d4e5f" \
  -H "Authorization: Bearer $FLOWEET_API_KEY"

Réponse 200

{
  "id": "28898708-4170-48bb-a3f5-e9b0d5d7ee53",
  "name": "Carrefour",
  "brand": "Carrefour",
  "city": "Rambouillet",
  "postalCode": "78120",
  "country": "FR",
  "fuels": [
    "B7",
    "GPL",
    "SP95",
    "SP95_E10",
    "SP98"
  ],
  "services": [],
  "open24h": true,
  "prices": {
    "B7": {
      "price": 2409,
      "updatedAt": "2026-10-24T20:51:00+00:00"
    },
    "GPL": {
      "price": 1102,
      "updatedAt": "2026-10-24T20:51:00+00:00"
    },
    "SP95": {
      "price": 2159,
      "updatedAt": "2026-10-24T20:51:00+00:00"
    },
    "SP98": {
      "price": 2225,
      "updatedAt": "2026-10-24T20:51:00+00:00"
    },
    "SP95_E10": {
      "price": 2119,
      "updatedAt": "2026-10-24T20:51:00+00:00"
    }
  },
  "address": "RN10 CENTRE COMMERCIAL DU BEL AIR",
  "location": {
    "lat": 48.6250208716154,
    "lng": 1.82953830436914
  },
  "heavyVehicleAccess": false,
  "openingHours": {}
}