API publique · Bêta · Accès sur demande

Les données carburant de Floweet, dans vos outils.

Prix de la semaine et classement des enseignes, stations et bornes de recharge, annuaire SIRENE avec l'estimation des flottes, surcoût carburant et carbone d'une flotte, prospects et simulations : une API REST en JSON, documentée en français et en anglais, avec un bac à sable.

Demander un accès Lire la documentation

Notre équipe ouvre chaque accès : une clé de bac à sable d'abord, la production après validation.

21 opérations · 10 scopes · OpenAPI 3.1

Requête

curl "https://api.floweet.com/v1/barometer?fuel=gazole" \
  -H "Authorization: Bearer $FLOWEET_API_KEY"

Réponse · 200 (extrait)

{
  "fuel": "gazole",
  "pricesFrom": "2026-10-19T11:35:43.000Z",
  "pricesTo": "2026-10-26T11:00:00.000Z",
  "national": {
    "excludingHighways": {
      "brands": [
        {
          "brand": "Total Access",
          "averagePrice": 2252,
          "stations": 219,
          "others": false
        },
        {
          "brand": "TotalEnergies",
          "averagePrice": 2252,
          "stations": 743,
          "others": false
        }
      ],
      "stations": 6024
    }
  }
}

Pour qui

Une API pour ceux qui vendent et gèrent la mobilité

Cartes carburant
Émetteurs de cartes
Chiffrez le surcoût d'un prospect sur les prix de la semaine, simulez la couverture de votre réseau autour de lui et rédigez l'argumentaire, depuis votre CRM.
Réseaux
Réseaux de stations
Suivez votre position dans le classement des enseignes, en France et dans chaque région, et comparez vos prix à ceux de la concurrence locale.
Flottes
Gestionnaires et logiciels de flotte
Affichez à vos clients les stations les moins chères de leur département, le surcoût de leur enseigne actuelle et leur coût carbone ETS2 à partir de 2028.
Outils commerciaux
CRM et outils de prospection
Enrichissez vos fiches avec l'annuaire SIRENE, l'activité, le réseau d'enseigne et l'estimation de la flotte de chaque établissement.

Ressources

Tout ce que l'API sert aujourd'hui

Chaque ligne vient du contrat que l'API applique : les opérations et les scopes ci-dessous sont exactement ceux qu'elle accepte.

RessourceCe qu'elle permetOpérations

Baromètre
barometer:read
Le classement des enseignes par prix moyen, en France et dans les 13 régions, pour cinq carburants, autoroutes comprises ou non.
- GET/v1/barometer
Stations carburant
fuel-stations:read
Les stations de France et d'Europe : prix par carburant, services, horaires, et les dix moins chères d'un département.
Bornes de recharge
charging-stations:read
Les bornes publiques du fichier IRVE : réseau, puissance, prises, gratuité, paiement par carte.
- GET/v1/charging-stations
- GET/v1/charging-stations/{id}
Entreprises
companies:read
L'annuaire SIRENE : recherche par nom, SIREN ou SIRET, unité légale, activité et flotte estimée.
- GET/v1/companies
- GET/v1/companies/{siret}
Coût d'une flotte
fleet-costs:read
Le surcoût annuel à la pompe d'une flotte par type de véhicule et son coût carbone ETS2. Rien n'est enregistré.
- POST/v1/fleet-costs
Prospects
prospects:readprospects:write
Les flottes de vos prospects, avec leur surcoût recalculé sur les prix de la semaine.
Simulations
simulations:readsimulations:write
La couverture de votre réseau autour d'un client, son statut commercial et son argumentaire de vente.
Géocodage et itinéraires
geo:read
Les coordonnées d'une adresse et un itinéraire routier de 2 à 25 points.
- GET/v1/geocode
- POST/v1/routes

En préparation

BientôtEspace développeurCréer et révoquer vos clés, suivre votre consommation, demander la production vous-même.
BientôtWebhooks sortantsÊtre prévenu d'un changement de prix ou de l'avancement d'une simulation, sans interroger l'API.
BientôtServeur MCPLes mêmes opérations, ouvertes aux assistants IA, avec les mêmes scopes.
BientôtAccès inclus dans les offresOuvrir l'API depuis votre abonnement, sans demande, avec un forfait d'appels.

Comment ça marche

De la demande à la production, en trois étapes

1
Vous demandez un accès
Indiquez votre organisation, le membre ADMIN au nom duquel la clé agira et ce que vous souhaitez construire.
2
Vous intégrez en bac à sable
Une clé fw_test_ lit et écrit les mêmes données que la production, sans jamais appeler l'IA, dans la limite de 1 000 appels par jour.
3
Vous passez en production
Après validation par notre équipe, vous recevez une clé fw_live_ : le même code, sans autre changement.

Une clé, des scopes

Une clé appartient à une organisation et porte la liste de ce qu'elle peut faire : un scope par route, en lecture ou en écriture (barometer:read, prospects:write…). Une route hors de ses scopes répond 403 insufficient_scope.

Votre premier appel

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

Conçue selon les standards

Rien à apprendre que vous ne connaissiez déjà

Authorization: Bearer
Une clé, un en-tête
Authentification par jeton porteur en HTTPS, jamais dans l'URL ni dans un cookie.
Idempotency-KeyIdempotent-Replayed
POST sans doublon
Rejouez un POST avec la même clé d'idempotence : la première réponse revient pendant 24 heures, rien n'est créé deux fois.
RateLimit-LimitRateLimit-RemainingRateLimit-ResetRetry-After
Limites annoncées
120 requêtes par minute et par organisation, annoncées dans chaque réponse ; un 429 dit quand réessayer.
nextCursorhasMorelimit
Pagination par curseur
Les listes répondent { data, nextCursor, hasMore } : stables même quand des lignes arrivent entre deux pages.
201Location
Ressource créée
Une création répond 201 avec l'adresse de la nouvelle ressource.
Floweet-VersionFloweet-Environment
Version et environnement
Chaque réponse dit la version du contrat et l'environnement de la clé (test ou live).
X-Request-Id
Traçabilité
Chaque requête porte un identifiant, repris dans nos journaux : citez-le si vous nous écrivez.
Accept-Language
Messages dans votre langue
Les messages d'erreur suivent Accept-Language : français, anglais, espagnol, italien, allemand, portugais.

Une seule forme d'erreur

Toutes les erreurs ont la même forme, avec un code stable sur lequel votre code peut s'appuyer.

La table des codes d'erreur

{
  "error": {
    "code": "insufficient_scope",
    "message": "This API key does not have the scope required by this route.",
    "details": { "required": "prospects:write", "granted": ["barometer:read"] }
  }
}

Exemple

Du surcoût d'une flotte à l'argumentaire de vente

Trois appels suffisent à chiffrer une flotte, l'enregistrer comme prospect et rédiger l'argumentaire d'une simulation de couverture.

1. Chiffrer la flotte

Le surcoût annuel à la pompe par type de véhicule, comparé à l'enseigne la moins chère, et le coût carbone ETS2. Rien n'est enregistré.

curl -X POST "https://api.floweet.com/v1/fleet-costs" \
  -H "Authorization: Bearer $FLOWEET_API_KEY" \
  -H "Idempotency-Key: 6f1c2b0e-8d4a-4f7e-9a51-3c2d1e0f9b87" \
  -H "Content-Type: application/json" \
  -d '{
  "fuel": "gazole",
  "currentBrand": "Esso",
  "reference": "cheapest",
  "kmPerVehicle": 30000,
  "lines": [
    {
      "type": "lcv",
      "vehicles": 12,
      "consumptionL100": 8.5
    },
    {
      "type": "hgv",
      "vehicles": 3,
      "consumptionL100": 30
    }
  ]
}'

2. L'enregistrer comme prospect

La même flotte, gardée et recalculée chaque semaine. La clé d'idempotence évite tout doublon si vous réessayez.

curl -X POST "https://api.floweet.com/v1/prospects" \
  -H "Authorization: Bearer $FLOWEET_API_KEY" \
  -H "Idempotency-Key: 6f1c2b0e-8d4a-4f7e-9a51-3c2d1e0f9b87" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Transports Martin",
  "fleet": {
    "fuel": "gazole",
    "currentBrand": "Esso",
    "reference": "cheapest",
    "kmPerVehicle": 30000,
    "lines": [
      {
        "type": "lcv",
        "vehicles": 12,
        "consumptionL100": 8.5
      },
      {
        "type": "hgv",
        "vehicles": 3,
        "consumptionL100": 30
      }
    ]
  }
}'

3. Rédiger l'argumentaire

Pour une simulation de couverture de votre réseau : rédigé par l'IA avec une clé live, au gabarit en bac à sable.

curl -X POST "https://api.floweet.com/v1/simulations/7d0c1f8e-2a4b-4c6d-9e8f-0a1b2c3d4e5f/pitch" \
  -H "Authorization: Bearer $FLOWEET_API_KEY" \
  -H "Idempotency-Key: 6f1c2b0e-8d4a-4f7e-9a51-3c2d1e0f9b87"

Garanties

Sûre par construction

Clés jamais stockées
Seule l'empreinte SHA-256 de votre clé est gardée. Une révocation s'applique en moins d'une minute.
Serveur à serveur
Aucune requête de navigateur n'est acceptée sur /v1 : votre clé reste sur votre serveur.
Les droits d'un membre
La clé agit au nom d'un membre ADMIN désigné de votre organisation : elle voit ce qu'il voit, avec votre offre, jamais plus.
Scopes en liste fermée
Dix scopes possibles, vérifiés par l'API et par la base de données.
Bac à sable sans IA
Une clé fw_test_ n'appelle jamais l'IA, dans la limite de 1 000 appels par jour.
Un contrat généré
La documentation vient des schémas qui valident vos requêtes : elle ne peut pas les contredire.
Jamais de rupture
/v1 ne retire ni ne renomme jamais rien. Une rupture fera une /v2, avec 12 mois de coexistence.
Un journal minimal
Chaque appel est journalisé sans adresse IP ni contenu, et gardé 12 mois.
Hébergée en France
Base de données et API tournent sur nos serveurs en France.

Notre politique de confidentialité Conditions d'utilisation

Documentation

Tout est écrit, en français et en anglais

La documentation complèteDémarrage rapide, authentification, bac à sable, scopes, chaque ressource et chaque opération, pagination, idempotence, limites, erreurs et versions, avec des exemples en curl, JavaScript et Python.Ouvrir la documentation

Questions fréquentes

Comment obtenir une clé d'API ?

Écrivez à contact@floweet.com en indiquant votre organisation, le membre ADMIN au nom duquel la clé agira et votre projet. Notre équipe vous remet une clé de bac à sable fw_test_, puis une clé de production fw_live_ après validation.

Combien coûte l'API ?

L'API est en bêta : l'accès est ouvert sur demande, sans facturation à l'appel. Les limites sont fixes : 120 requêtes par minute et par organisation, 1 000 appels par jour en bac à sable.

D'où viennent les données ?

Prix : prix-carburants.gouv.fr. Bornes : fichier consolidé IRVE. Entreprises : répertoire SIRENE de l'Insee. Adresses : Base Adresse Nationale, puis OpenStreetMap. Toute réutilisation doit citer ces sources.

Que fait une clé de bac à sable ?

Une clé fw_test_ lit et écrit les mêmes données que la production, mais n'appelle jamais l'IA : l'argumentaire est rédigé au gabarit. Elle est limitée à 1 000 appels par jour.

Puis-je appeler l'API depuis un navigateur ?

Non. La clé est un secret : l'API n'accepte pas les requêtes de navigateur sur /v1. Appelez-la depuis votre serveur.

L'API peut-elle changer ?

/v1 ne retire ni ne renomme jamais un champ ni une route : seuls des ajouts sont possibles. Une rupture fera une /v2, servie 12 mois aux côtés de /v1.

Branchez Floweet sur vos outils

Une clé de bac à sable vous attend : écrivez-nous, nous ouvrons l'accès.

Demander un accès Lire la documentation

Bac à sable sur les mêmes données
Documentation en français et en anglais
Aucune rupture sur /v1

Les données carburant de Floweet, dans vos outils.

Une API pour ceux qui vendent et gèrent la mobilité

Émetteurs de cartes

Réseaux de stations

Gestionnaires et logiciels de flotte

CRM et outils de prospection

Tout ce que l'API sert aujourd'hui

En préparation

De la demande à la production, en trois étapes

Vous demandez un accès

Vous intégrez en bac à sable

Vous passez en production

Une clé, des scopes

Votre premier appel

Rien à apprendre que vous ne connaissiez déjà

Une clé, un en-tête

POST sans doublon

Limites annoncées

Pagination par curseur

Ressource créée

Version et environnement

Traçabilité

Messages dans votre langue

Une seule forme d'erreur

Du surcoût d'une flotte à l'argumentaire de vente

1. Chiffrer la flotte

2. L'enregistrer comme prospect

3. Rédiger l'argumentaire

Sûre par construction

Clés jamais stockées

Serveur à serveur

Les droits d'un membre

Scopes en liste fermée

Bac à sable sans IA

Un contrat généré

Jamais de rupture

Un journal minimal

Hébergée en France

Tout est écrit, en français et en anglais

Questions fréquentes

Branchez Floweet sur vos outils