Atlas sert des indicateurs pays, régionaux et infranationaux en JSON, normalisés quelle que soit la source d'origine — Banque mondiale, Data360, Eurostat, OCDE, Banque de France, INSEE, Statistique Canada et d'autres. Une seule forme de réponse, une seule clé, un historique qui remonte à 1960 sur les séries annuelles les plus longues.
Deux règles gouvernent toutes les réponses : une valeur manquante reste absente du tableau de points, jamais interpolée ; et un échec réseau d'une source (unavailable: true) ne se confond jamais avec une absence réelle de donnée.
Toute route sous /api/* accepte un en-tête X-API-Key. Il est optionnel : sans lui, la requête est anonyme et servie quand même, sous une limite globale de 240 requêtes/minute par IP. Avec une clé valide, c'est le palier de la clé qui fixe la limite par minute et le quota mensuel.
curl -H "X-API-Key: $ATLAS_KEY" \ "https://atlasfeed.fr/api/country/FRA/series?indicators=NY.GDP.MKTP.CD&start=2018"
Quotas comptés par mois calendaire. Un dépassement renvoie 429, jamais de facturation surprise.
Un cinquième palier, consumer_pro (10 requêtes/minute, 2 000 par mois), accompagne l'offre grand public : il s'attache à un compte, il ne se vend pas comme clé API. Les tarifs sont sur atlasfeed.fr/tarifs-api.
Le contrôle de clé s'exécute avant la logique de chaque route et ne renvoie que trois formes d'erreur, toutes bâties sur une clé error : invalid_api_key (401), rate_limit_exceeded (429) et quota_exceeded (429).
{"error": "invalid_api_key"}
{
"error": "quota_exceeded",
"tier": "free",
"monthlyLimit": 1000,
"resetsAt": "2026-10-01T00:00:00+00:00"
}
Une erreur levée par la route elle-même (pays inconnu, indicateur inconnu, paramètre invalide) prend l'autre forme, celle de FastAPI : {"detail": "…"}, avec un message localisé selon l'en-tête Accept-Language. Les quatre formes exactes, champ par champ, sont détaillées sur Démarrage.
Chaque page couvre un groupe de routes : description, tableau exhaustif des paramètres et des codes d'erreur, exemples curl / Python / JavaScript et exemple de réponse.
Le socle commun : authentification par X-API-Key, paliers, quotas mensuels, format d'erreur partagé et sonde de disponibilité.
GET /api/health
LireParcourir et chercher dans le catalogue — indicateurs curatés, longue traîne, recherche multilingue, métadonnées et sources créditées.
/api/indicators · /api/stats · /api/sources · /api/indicators/explore · /api/indicators/search · /api/catalog/browse · /api/indicator/{code}/meta
LireLe cœur de l'API : identité d'un pays, séries temporelles, comparaison multi-pays, séries mensuelles, classements mondiaux et prévisions.
/api/countries · /api/country/{code} · …/series · …/monthly/{indicator} · …/forecast · …/rank/{indicator} · /api/compare · /api/rank/{indicator} · …/current
LireAgrégats de zone recalculés (jamais repris d'une source), zones sur mesure, et le sous-Atlas infranational : régions, états, provinces, départements, comtés.
/api/regions · /api/region/{code} · /api/region/custom/aggregate · /api/subdivisions/*
LireFiger une sélection et ses valeurs sous un identifiant immuable, puis la projeter en douze formats — CSV, XLSX, SVG, BibTeX, oEmbed… — et la couverture réelle du catalogue.
/api/capture · /api/capture/{id} · /api/oembed · /c/{id} · /api/chart/*.svg · /api/coverage
LireÉmettre et révoquer ses clés, retrouver une clé perdue, lire le palier effectif d'une clé. La plupart de ces routes servent le site lui-même, par cookie de session.
/api/auth/recover · /api/account/*
LireLe tunnel d'achat Stripe et l'accès au portail client par lien magique. Routes internes au front, documentées ici pour référence.
/api/billing/checkout · /api/billing/portal · /api/billing/webhook
Lire