API publique et gratuite
API des index BT et TP
Les index INSEE du bâtiment et des travaux publics, les coefficients de révision, le calendrier des publications et les jours fériés, en JSON, CSV ou calendrier. Pour vos tableurs, votre ERP ou vos scripts : plus de valeurs recopiées à la main.
Points d'accès
Adresse de base : https://www.framegenesis.com/api/v1. Réponses en JSON ; ajoutez format=csv pour du CSV (et locale=fr pour Excel en français : point-virgule et virgule décimale). Chaque réponse JSON porte un bloc meta : source, dernier mois, date de publication, prochaine publication et indicateur stale.
Liste des index : code, libellé, famille, statut (actif ou arrêté, avec son successeur), dernier mois publié.
Dernière valeur de chaque index et évolution sur 12 mois.
Valeurs mensuelles d'un index (from et to facultatifs, AAAA-MM).
Tableau mois × index, la forme attendue par Excel (Power Query) et Google Sheets (IMPORTDATA).
Coefficient de révision, valeurs utilisées et explication. Options : lag, decimals, rounding=up, fallback=last.
Jusqu'à 200 contrats en un appel : { "contracts": [ { "id", "formula", "base", "month", "lag" } ] }.
Dates de publication des index (passées et à venir) ; ?format=ics pour s'y abonner dans un agenda.
Jours fériés : FR-MET, FR-ALS-MOS, FR-GP, FR-MQ, FR-GF, FR-RE, FR-YT. CSV et ICS disponibles.
Modèles Excel et Word générés avec les dernières valeurs.
Exemples
Coefficient de révision
curl "https://www.framegenesis.com/api/v1/revision?formula=0.15%2B0.85*TP01&base=2025-03&month=2026-08"{
"coefficient": …,
"rounded": …,
"provisional": false,
"terms": [{ "code": "TP01", "weight": 0.85,
"base": { "period": "2025-03", "value": … },
"current": { "period": "2026-08", "value": … } }],
"explanation": "C = 0,15 + 0,85 × TP01(2026-08) / TP01(2025-03) …"
}Google Sheets : un onglet qui se met à jour seul
=IMPORTDATA("https://www.framegenesis.com/api/v1/indices/table?codes=TP01,BT01&from=2020-01&format=csv"; ","; "en_US")Excel : Power Query
Données → À partir du Web → cette adresse, puis Charger. Chaque mois : Données → Actualiser tout.
https://www.framegenesis.com/api/v1/indices/table?codes=TP01,BT01&from=2020-01&format=csv&locale=frPlusieurs contrats d'un coup
curl -X POST https://www.framegenesis.com/api/v1/revision \
-H "content-type: application/json" -H "x-api-key: VOTRE_CLE" \
-d '{"contracts":[{"id":"CH-014","formula":"0.15+0.85*TP01","base":"2025-03"},
{"id":"CH-021","formula":"0.125+0.5*TP01+0.375*TP10f","base":"2025-06","fallback":"last"}]}'Les modèles Excel FrameGenesis utilisent exactement ce tableau dans leur onglet Index : branchez-le une fois, vos situations, DGD et tableaux de révision restent à jour.
Clé gratuite
Sans clé : 60 requêtes par minute. Avec une clé : 600 par minute. La clé s'envoie dans l'en-tête x-api-key.
Conditions : citer « Source : Insee », ne pas revendre les données telles quelles, et accepter que l'API évolue (versionnée : les changements incompatibles iront dans /api/v2).
Questions fréquentes
L'API est-elle gratuite ?
Oui. Sans clé, elle répond à 60 requêtes par minute et par adresse IP. Avec une clé gratuite, 600 requêtes par minute. Merci de citer la source : « Source : Insee ».
D'où viennent les données ?
De la base de données macro-économiques de l'INSEE (index BT, TP et divers de la construction, base 2010), lue directement et mise à jour le jour même de chaque publication. Chaque réponse indique la date de publication et un indicateur stale si l'INSEE a publié depuis.
Les codes d'index peuvent-ils changer ?
Non : un code n'est jamais renommé. Quand l'INSEE arrête une série (TP10a, TP13), elle reste disponible avec son statut « arrêté » et son successeur, dont les valeurs reprennent son historique.
Comment l'utiliser dans Excel ?
Données → À partir du Web → collez l'adresse du tableau au format CSV français (format=csv&locale=fr). Excel crée une requête Power Query ; chaque mois, Données → Actualiser tout. Testé avec Excel pour Windows ; sur Mac, Power Query sait aussi lire une adresse web dans les versions récentes.
Brancher les index sur votre ERP ou votre logiciel de facturation
Révision calculée à chaque situation, index récupérés automatiquement, alertes à la publication : on intègre l'API à vos outils existants.
Cet outil a été développé par FrameGenesis. On construit la même chose pour vos process : logiciel métier, automatisations, intégration à votre ERP.
Outils liés
- Index BT et TP : Dernières valeurs de TP01, BT01 et de tous les index BT, TP et divers de l'INSEE, classés par métier et mis à jour chaque mois.
- Tableau de révision multi-marchés : Tous vos marchés révisables sur un tableau : formules à plusieurs index, partie fixe, mois zéro, décalage, coefficients des 12 derniers mois et actualisation. Index INSEE à jour.
- Révision de prix BTP : Coefficient et montant révisé avec les derniers index INSEE TP et BT, formules à un ou plusieurs index, historique sur 12 mois.
- Tous les outils gratuits