API publique gratuite

Endpoints disponibles

Exemple : dette en direct

Renvoie le montant de la dette française au moment précis de la requête, son ratio dette/PIB, et la cadence d'augmentation par seconde.

curl https://dettedelafrance.fr/api/v1/debt

{
  "ok": true,
  "as_of": "2026-05-06T12:34:56+00:00",
  "debt_eur": 3505421890234.12,
  "debt_eur_billions": 3505.42,
  "debt_per_capita_eur": 51249.87,
  "gdp_eur": 3019845200000,
  "debt_to_gdp_ratio_pct": 116.08,
  "rate_eur_per_second": 4836.22,
  "rate_eur_per_minute": 290173.45,
  "rate_eur_per_day": 417857088,
  "official_baseline": {
    "value_eur": 3460500000000,
    "date": "2025-12-31",
    "source": "INSEE (dette au sens de Maastricht)"
  },
  "methodology": "https://dettedelafrance.fr/methodologie",
  "license": "CC BY 4.0, citation : « Source : dettedelafrance.fr »"
}

Exemple : récupérer une métrique précise

fetch('https://dettedelafrance.fr/api/v1/metrics/oat10Rate')
  .then(r => r.json())
  .then(data => console.log('Taux OAT 10 ans :', data.metric.value, '%'));

import requests
r = requests.get('https://dettedelafrance.fr/api/v1/metrics')
for m in r.json()['metrics']:
    print(f"{m['label']}: {m['value']} {m['unit']} (source: {m['source']})")

Badge PNG : /api/badge.png

Pour les supports qui n'exécutent ni JavaScript ni iframe (newsletters, forums, README GitHub, Notion…) : une image PNG de 600 × 90 px aux couleurs du site, qui affiche la dette du jour en milliards d'euros. Le badge est régénéré côté serveur au plus toutes les heures (cache fichier + Cache-Control: max-age=3600) : vous pouvez le référencer directement, sans quota particulier.

<a href="https://dettedelafrance.fr"><img src="https://dettedelafrance.fr/api/badge.png" alt="Dette de la France en direct, dettedelafrance.fr" width="600" height="90"></a>

[![Dette de la France](https://dettedelafrance.fr/api/badge.png)](https://dettedelafrance.fr)

Besoin d'un compteur animé seconde par seconde ? Utilisez plutôt le widget iframe (configurateur visuel inclus).

Conditions d'utilisation

• Licence Creative Commons BY 4.0 : vous pouvez tout faire (commercial inclus), sauf retirer la citation.
• Citation requise : « Source : dettedelafrance.fr » avec lien si possible.
• Pas de scraping abusif : quota de 300 requêtes/heure/IP. Au-delà, contactez-nous pour un accès dédié (gratuit aussi).
• Pas de garantie : les chiffres officiels sont fiables, les projections sont pédagogiques. Voir méthodologie.
• Aucune collecte de vos données : nous loguons l'IP hashée pour le quota, pas l'identité.