NanookAI/worldbank-api

Compétence pour agent IA qui permet de récupérer le PIB, la population, l'inflation et environ 30 000 autres indicateurs de développement via l'API gratuite de la Banque mondiale (sans clé API).

Qu'est-ce que worldbank-api ?

Cette compétence donne à un agent IA la capacité d'interroger l'API des indicateurs de la Banque mondiale, exposant environ 30 000 séries chronologiques pour 217 économies et 78 agrégats régionaux/revenus, certaines séries remontant à 1960. Elle ne nécessite ni clé API, ni inscription, et ne documente aucune limite de taux ; il suffit d'effectuer des requêtes HTTPS GET simples. La compétence fournit un script Python zéro-dépendance (via `scripts/wb_data.py`) pour les cas courants (PIB, population, inflation), ainsi qu'une documentation complète sur l'appel direct de l'API pour les besoins avancés (métadonnées pays, découverte d'indicateurs, séries mensuelles/trimestrielles, environnements non-Python). Elle prend en charge des paramètres comme `date`, `mrv` (N valeurs les plus récentes), `mrnev` (N valeurs non vides les plus récentes), `per_page` et `page` pour la pagination. Les codes d'indicateurs les plus utilisés (PIB, croissance, population, inflation, chômage, Gini, etc.) sont listés et vérifiés en direct. La compétence gère également les erreurs (codes 120, 175) et offre des conseils pratiques, comme l'utilisation de `mrnev=1` pour éviter les valeurs nulles et la définition d'une `per_page` élevée pour éviter la pagination. Elle est conçue pour fonctionner avec n'importe quel agent IA (Claude Code, Cursor, Codex, etc.) qui peut exécuter du code Python ou effectuer des requêtes HTTP.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add NanookAI/worldbank-api

Installed? Explore more Recherche et analyse de données skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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...), ou all (toutes les 265 économies+agrégats).
  • {indicator} — un code d'indicateur comme NY.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ètreSignification
date=2020 / date=2000:2024Année unique ou plage. Mensuel 2025M01:2025M06, trimestriel 2024Q1:2025Q4 pour les quelques sources mensuelles/trimestrielles.
mrv=NN valeurs les plus récentes par pays (remplace date)
mrnev=NN 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=YAvec 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=NNuméro de page ; boucler tant que page < pages dans les métadonnées
footnote=yAjoute 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)

CodeIndicateur
NY.GDP.MKTP.CDPIB (USD courants)
NY.GDP.MKTP.KD.ZGCroissance du PIB (% annuel)
NY.GDP.PCAP.CDPIB par habitant (USD courants)
NY.GNP.PCAP.CDRNB par habitant, méthode Atlas (USD courants)
SP.POP.TOTLPopulation totale
FP.CPI.TOTL.ZGInflation, prix à la consommation (% annuel)
SL.UEM.TOTL.ZSChômage (% de la population active, OIT)
SP.DYN.LE00.INEspérance de vie à la naissance (années)
SI.POV.GINIIndice de Gini
SI.POV.DDAYTaux de pauvreté à 3,00 $/jour (% de la population)
EN.GHG.CO2.PC.CE.AR5Émissions de CO2 par habitant (t CO2e)
IT.NET.USER.ZSUtilisateurs d'Internet (% de la population)
NE.EXP.GNFS.ZSExportations de biens et services (% du PIB)
BX.KLT.DINV.WD.GD.ZSEntrées nettes d'IDE (% du PIB)
PA.NUS.FCRFTaux de change officiel (monnaie locale par USD)
SP.URB.TOTL.IN.ZSPopulation 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 CO2 EN.ATM.CO2E.PC → utilisez les remplacements EN.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=1 pour "le dernier nombre" — la plupart des séries accusent un retard d'un à deux ans, donc mrv=1 renvoie souvent l'année la plus récente avec value: null.
  • Définissez per_page élevé (ex. 20000) et vous n'aurez presque jamais besoin de paginer ; all pays × une année ne fait que 265 lignes.
  • total dans 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 ; lastupdated dans 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 trimestrielle source=20/22/23) — voir references/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.

Skills associés