Aller au contenu

Entreprises, adresses, itinéraires et carburants

Données publiques par API : l’annuaire des entreprises (SIRENE), la base adresse nationale, les itinéraires routiers et les prix des carburants (prix-carburants.gouv.fr). Chaque outil a un quota gratuit mensuel, puis un prix à l’appel : voir les tarifs.

Rechercher une entreprise

GET/v1/companies?q=…

q : nom, enseigne, SIREN ou SIRET (3 caractères au moins) ; limit : 1 à 10 (5 par défaut) ; status : active (par défaut) ou all pour inclure les établissements fermés.

Requête
curl "https://api.vitef.com/v1/companies?q=transports%20martin&limit=2" \
  -H "Authorization: Bearer $VITEF_API_KEY"
Réponse 200
{
  "results": [
    {
      "name": "TRANSPORTS MARTIN",
      "siret": "39315281200029",
      "address": "12 Rue des Ardennes, 69100 Villeurbanne",
      "city": "Villeurbanne",
      "naf": "49.41A",
      "siren": "393152812",
      "headquarters": false,
      "active": true,
      "professional": true
    },
    {
      "name": "TRANSPORTS MARTIN",
      "siret": "39315281200011",
      "address": "5 Avenue Jean Jaures, 69007 Lyon",
      "city": "Lyon",
      "naf": "49.41A",
      "siren": "393152812",
      "headquarters": true,
      "active": true,
      "professional": true
    }
  ]
}

Fiche d’un établissement

GET/v1/companies/{siret}statut, siège, activité, effectif, fraîcheur des données

Requête
curl "https://api.vitef.com/v1/companies/39315281200011" \
  -H "Authorization: Bearer $VITEF_API_KEY"

Prix des carburants

GET/v1/fuel/prices?department=69moyennes du jour, France et département

Requête
curl "https://api.vitef.com/v1/fuel/prices?department=69" \
  -H "Authorization: Bearer $VITEF_API_KEY"

GET/v1/fuel/stationsstations les moins chères

fuel (gazole, sp95-e10, sp98, e85, gplc), insee (code commune) ou lat/lon, radiusKm (1 à 30), sort (price ou distance), limit (1 à 50).

Requête
curl "https://api.vitef.com/v1/fuel/stations?fuel=gazole&insee=69123&limit=5" \
  -H "Authorization: Bearer $VITEF_API_KEY"

Adresses et communes

GET/v1/geo/addresses?q=…autocomplétion et coordonnées

q : 3 caractères au moins ; limit : 1 à 10. Chaque résultat donne la rue, le code postal, la ville et les coordonnées.

Requête
curl "https://api.vitef.com/v1/geo/addresses?q=3%20rue%20merciere%20lyon&limit=1" \
  -H "Authorization: Bearer $VITEF_API_KEY"
Réponse 200
{
  "results": [
    {
      "label": "3 Rue Mercière 69002 Lyon",
      "street": "3 Rue Mercière",
      "postcode": "69002",
      "city": "Lyon",
      "lat": 45.764404,
      "lon": 4.832514
    }
  ]
}

GET/v1/geo/cities?q=69003communes d’un code postal ou d’un nom

Itinéraire routier

GET/v1/routes?from=…&to=…distance et durée en voiture

from et to : une adresse ou des coordonnées « lon,lat » ; geometry=true ajoute le tracé simplifié pour une carte.

Requête
curl "https://api.vitef.com/v1/routes?from=Lyon&to=Grenoble" \
  -H "Authorization: Bearer $VITEF_API_KEY"
Réponse 200
{
  "distanceKm": 107.4,
  "durationMin": 81,
  "from": {
    "lat": 45.758,
    "lon": 4.835,
    "label": "Lyon"
  },
  "to": {
    "lat": 45.182828,
    "lon": 5.724301,
    "label": "Grenoble"
  }
}

Réponses détaillées dans la référence.