API des indicateurs de la Banque mondiale
L'API des indicateurs de la Banque mondiale expose environ 30 000 séries chronologiques pour 217 économies et 78 agrégats régionaux/par revenu, certaines séries remontant à 1960. Pas de clé API, pas d'inscription, aucune limite de taux documentée — simple requête HTTPS GET.
URL de base : https://api.worldbank.org/v2
Ajoutez toujours format=json — le format de réponse par défaut est XML.
Chemin le plus rapide : script fourni
Pour le cas courant — un ou plusieurs indicateurs pour un ou plusieurs pays — exécutez le script zéro-dépendance fourni (Python 3.8+, bibliothèque standard uniquement) :
python3 scripts/wb_data.py gdp US,JP,CN # alias + codes ISO, 5 dernières années
python3 scripts/wb_data.py SP.POP.TOTL BR --date 2000:2024 # code indicateur explicite + plage
python3 scripts/wb_data.py inflation all --mrv 1 # chaque économie, dernière valeur
python3 scripts/wb_data.py population WLD,EUU --json # agrégats, sortie JSON brute
python3 scripts/wb_data.py --search "renewable energy" # trouver des codes d'indicateurs par mot-clé
python3 scripts/wb_data.py --aliases # lister les alias d'indicateurs intégrés
Codes de sortie : 0 succès, 1 non trouvé / pas de données, 2 erreur API ou réseau.
Appelez l'API directement (ci-dessous) pour tout le reste : métadonnées pays, découverte d'indicateurs par thème/source, séries mensuelles/trimestrielles, ou environnements non-Python.
Requête de données principale
GET https://api.worldbank.org/v2/country/{codes}/indicator/{indicator}?format=json
{codes}— codes pays ISO-2 ou ISO-3, séparés par point-virgule (US;JP;CN), un code agrégé (WLD,EUU,HIC...), ouall(toutes les 265 économies+agrégats).{indicator}— un code d'indicateur commeNY.GDP.MKTP.CD(insensible à la casse).
Exemple
GET https://api.worldbank.org/v2/country/US;JP/indicator/NY.GDP.MKTP.CD?format=json&mrv=2
[
{"page": 1, "pages": 1, "per_page": 50, "total": 4,
"sourceid": "2", "lastupdated": "2026-07-01"},
[
{"indicator": {"id": "NY.GDP.MKTP.CD", "value": "GDP (current US$)"},
"country": {"id": "US", "value": "United States"},
"countryiso3code": "USA", "date": "2025",
"value": 30769700000000, "unit": "", "obs_status": "", "decimal": 0},
{"...": "un objet par pays×année, les plus récents en premier"}
]
]
Forme de la réponse : un tableau JSON de 2 éléments — [0] contient les métadonnées de pagination,
[1] est le tableau de données (ou null si rien n'a correspondu). value est null
pour les années où un pays n'a pas déclaré. Les lignes sont triées des plus récentes aux plus anciennes par pays.
Paramètres de temps et de pagination
| Paramètre | Signification |
|---|---|
date=2020 / date=2000:2024 | Année unique ou plage. Mensuel 2025M01:2025M06, trimestriel 2024Q1:2025Q4 pour les quelques sources mensuelles/trimestrielles. |
mrv=N | N valeurs les plus récentes par pays (remplace date) |
mrnev=N | N valeurs les plus récentes non vides — à utiliser pour "dernière disponible" car de nombreuses séries accusent un retard de 1 à 2 ans |
gapfill=Y | Avec mrv : remplit les années manquantes avec la dernière valeur connue |
per_page=N (défaut 50) | Lignes par page ; les grandes valeurs (ex. 20000) fonctionnent bien — définissez-la élevée pour éviter la pagination |
page=N | Numéro de page ; boucler tant que page < pages dans les métadonnées |
footnote=y | Ajoute un champ footnote à chaque point de données |
Plusieurs indicateurs dans un même appel nécessitent une source explicite :
/country/BR/indicator/NY.GDP.MKTP.CD;SP.POP.TOTL?source=2&format=json
(source 2 = Indicateurs du développement dans le monde, abritant la plupart des séries courantes).
Codes d'indicateurs les plus utilisés (tous vérifiés en direct)
| Code | Indicateur |
|---|---|
NY.GDP.MKTP.CD | PIB (USD courants) |
NY.GDP.MKTP.KD.ZG | Croissance du PIB (% annuel) |
NY.GDP.PCAP.CD | PIB par habitant (USD courants) |
NY.GNP.PCAP.CD | RNB par habitant, méthode Atlas (USD courants) |
SP.POP.TOTL | Population totale |
FP.CPI.TOTL.ZG | Inflation, prix à la consommation (% annuel) |
SL.UEM.TOTL.ZS | Chômage (% de la population active, OIT) |
SP.DYN.LE00.IN | Espérance de vie à la naissance (années) |
SI.POV.GINI | Indice de Gini |
SI.POV.DDAY | Taux de pauvreté à 3,00 $/jour (% de la population) |
EN.GHG.CO2.PC.CE.AR5 | Émissions de CO2 par habitant (t CO2e) |
IT.NET.USER.ZS | Utilisateurs d'Internet (% de la population) |
NE.EXP.GNFS.ZS | Exportations de biens et services (% du PIB) |
BX.KLT.DINV.WD.GD.ZS | Entrées nettes d'IDE (% du PIB) |
PA.NUS.FCRF | Taux de change officiel (monnaie locale par USD) |
SP.URB.TOTL.IN.ZS | Population urbaine (% du total) |
Environ 100 autres codes vérifiés, regroupés par thème dans references/indicators.md —
consultez-le chaque fois que la série nécessaire n'est pas dans ce tableau. Pour rechercher
par mot-clé, utilisez l'option --search du script ou les points de terminaison de découverte dans
references/endpoints.md (il n'y a pas de recherche textuelle côté serveur sur l'API).
Codes pays et agrégats
Pays : ISO-2 (US) ou ISO-3 (USA) fonctionnent tous les deux. Agrégats utiles :
WLD Monde, EUU Union européenne, EMU zone euro, HIC/UMC/LMC/LIC
groupes de revenus, EAS Asie de l'Est et Pacifique, ECS Europe et Asie centrale,
LCN Amérique latine et Caraïbes, MEA Moyen-Orient et Afrique du Nord,
SAS Asie du Sud, SSF Afrique subsaharienne, NAC Amérique du Nord.
country/all renvoie les économies et les agrégats mélangés (265 lignes
par an). Pour ne garder que les pays réels, récupérez
/v2/country?format=json&per_page=400 une fois et supprimez les entrées où
region.value == "Aggregates".
Métadonnées pays (région, niveau de revenu, capitale, coordonnées) :
GET https://api.worldbank.org/v2/country/JPN?format=json
GET https://api.worldbank.org/v2/country?incomeLevel=LIC&format=json&per_page=100
Exemples de code
import requests
def wb_series(indicator: str, countries: str = "all", **params) -> list[dict]:
"""Récupère une série de la Banque mondiale ; renvoie une liste plate de points de données."""
url = f"https://api.worldbank.org/v2/country/{countries}/indicator/{indicator}"
r = requests.get(url, params={"format": "json", "per_page": 20000, **params}, timeout=30)
r.raise_for_status()
body = r.json()
if "message" in body[0]: # les erreurs API reviennent en HTTP 200
raise ValueError(body[0]["message"][0]["value"])
return body[1] or []
gdp = wb_series("NY.GDP.MKTP.CD", "US;JP;CN", date="2015:2024")
latest = wb_series("SP.DYN.LE00.IN", "all", mrnev=1)
const url = "https://api.worldbank.org/v2/country/US;JP/indicator/NY.GDP.MKTP.CD"
+ "?format=json&mrv=5&per_page=1000";
const [meta, rows] = await (await fetch(url)).json();
if (meta.message) throw new Error(meta.message[0].value);
for (const r of rows ?? []) console.log(r.country.value, r.date, r.value);
Erreurs
Les erreurs reviennent en code HTTP 200 avec une enveloppe de message — vérifiez-la toujours :
[{"message": [{"id": "120", "key": "Invalid value",
"value": "The provided parameter value is not valid"}]}]
120— code pays ou indicateur invalide (également renvoyé pour les économies que la Banque mondiale ne couvre pas, ex. Taïwan n'a aucune donnée sous quelque code que ce soit).175— l'indicateur existe mais ses données ont été supprimées ou archivées (ex. l'ancienne série CO2EN.ATM.CO2E.PC→ utilisez les remplacementsEN.GHG.*; toute la source Doing Business est archivée). Recherchez un code successeur.- Occasionnellement, pages HTML transitoires "Request Error" au lieu de JSON — réessayez une fois avant de considérer comme un échec.
Conseils pratiques
- Préférez
mrnev=1àmrv=1pour "le dernier nombre" — la plupart des séries accusent un retard d'un à deux ans, doncmrv=1renvoie souvent l'année la plus récente avecvalue: null. - Définissez
per_pageélevé (ex.20000) et vous n'aurez presque jamais besoin de paginer ;allpays × une année ne fait que 265 lignes. totaldans les métadonnées compte les créneaux pays×période, y compris les valeurs nulles.- Noms localisés : insérez un code de langue après
/v2—/v2/zh/country/CN/indicator/...(supporté :en,es,fr,ar,zh). Seules les étiquettes sont traduites ; les codes et les valeurs sont identiques. - Les révisions de données arrivent environ mensuellement ;
lastupdateddans les métadonnées indique la date d'actualisation de la source. - Annuel est la norme. Mensuel/trimestriel n'existe que dans quelques sources (Global
Economic Monitor
source=15, dette trimestriellesource=20/22/23) — voirreferences/endpoints.md.
Pour le catalogue complet des points de terminaison (liste des indicateurs, thèmes, sources, régions,
niveaux de revenu, types de prêt, langues, données mensuelles/trimestrielles), lisez
references/endpoints.md ; pour environ 100 autres codes d'indicateurs vérifiés par thème, lisez
references/indicators.md.