L'API publique Olago
Trois endpoints en lecture seule : les métriques d'un segment, sa géométrie GeoJSON, et le score d'un portefeuille d'adresses. Réservé aux plans Pro et Max — créez une clé depuis votre compte.
Authentification
Chaque requête porte un en-tête Authorization: Bearer olg_…. La clé est générée UNE fois depuis vos réglages de compte — copiez-la immédiatement, elle n'est plus jamais réaffichée (seul un préfixe reste visible pour l'identifier). Une clé absente ou invalide renvoie 401 ; un plan insuffisant renvoie 403.
curl -H "Authorization: Bearer olg_VOTRE_CLE" \ https://olago.app/api/v1/segments/gr:75056_0001234
Endpoints
GET /api/v1/segments/{id}
Métriques d'un segment (mêmes données que la fiche). {id} accepte l'identifiant canonique gr:… ou un identifiant historique résolu automatiquement.
{
"id": "gr:75056_0001234",
"name": "Rue de Rivoli",
"hclass": "Grand axe",
"length_m": 142,
"metrics": [
{
"key": "commerces",
"label": "Commerces",
"value": 18,
"unit": "locaux (BDCOM 2023)",
"percentile": 87,
"source": "BDCOM 2023 (Apur, relevé terrain)",
"vintage": "2023"
}
],
"quota": { "plan": "pro", "remaining": 4999 }
}valueest toujours la valeur brute (canal machine) — jamais le formatage d'affichage humain (ex. les tranches de bruit affichées « 55-60 » sur la fiche restent ici un nombre brut, l'unité du catalogue explique la convention). percentile (0-100) peut être null (donnée non couverte sur ce segment) ; quand le champ normScopeest présent, le percentile n'est PAS calculé sur l'ensemble de la ville mais sur une population plus restreinte décrite par ce champ (ex. « parmi les 53 segments équipés d'un compteur vélo ») — ne jamais le lire comme un classement-ville.