World Bank Indicators API(世界銀行指標API) は何をしますか?
World Bank Indicators APIは、217の経済圏と78の地域・所得グループに関する約3万の時系列指標を公開しています。一部の系列は1960年まで遡ります。 APIキー不要、サインアップ不要、文書化されたレート制限なし — 単純なHTTPS GETリクエストです。
ベースURL: https://api.worldbank.org/v2
常にformat=jsonを付加してください — デフォルトのレスポンス形式はXMLです。
最速の方法:バンドルスクリプト
一般的なケース(1つ以上の国に対する1つ以上の指標)では、バンドルされた依存関係のないスクリプト(Python 3.8+、標準ライブラリのみ)を実行します:
python3 scripts/wb_data.py gdp US,JP,CN # エイリアス + ISOコード、最新5年
python3 scripts/wb_data.py SP.POP.TOTL BR --date 2000:2024 # 明示的な指標コード + 範囲
python3 scripts/wb_data.py inflation all --mrv 1 # すべての経済圏、最新値
python3 scripts/wb_data.py population WLD,EUU --json # 集計、生JSON出力
python3 scripts/wb_data.py --search "renewable energy" # キーワードで指標コードを検索
python3 scripts/wb_data.py --aliases # 組み込み指標エイリアスを一覧表示
終了コード: 0 成功、1 見つからない/データなし、2 APIまたはネットワークエラー。
それ以外(国メタデータ、トピック/ソース別の指標検索、月次/四半期系列、Python以外の環境)については、以下のAPIを直接呼び出してください。
コアデータクエリ
GET https://api.worldbank.org/v2/country/{codes}/indicator/{indicator}?format=json
{codes}— ISO-2またはISO-3の国コード、セミコロン区切り(US;JP;CN)、集計コード(WLD、EUU、HIC...)、またはall(265すべての経済圏+集計)。{indicator}—NY.GDP.MKTP.CDのような指標コード(大文字小文字は区別されません)。
例
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},
{"...": "国×年ごとに1オブジェクト、新しい順"}
]
]
レスポンスの構造: 2要素のJSON配列 — [0]はページネーションメタデータ、[1]はデータ配列(該当なしの場合はnull)。valueは、国が報告していない年に対してnullになります。行は国ごとに新しい順にソートされます。
時間とページネーションパラメータ
| パラメータ | 意味 |
|---|---|
date=2020 / date=2000:2024 | 単一年または範囲。月次は2025M01:2025M06、四半期は2024Q1:2025Q4(限られた月次/四半期ソースの場合)。 |
mrv=N | 国ごとの最新N値(dateを上書き) |
mrnev=N | 国ごとの最新N 非NULL 値 — 多くの系列が1〜2年遅れるため、「最新の利用可能な値」に使用 |
gapfill=Y | mrvと併用:欠落年を最後の既知の値で前方補完 |
per_page=N(デフォルト50) | 1ページあたりの行数;大きな値(例:20000)でも正常に動作 — ページネーションを避けるために高く設定 |
page=N | ページ番号;メタデータのpage < pagesの間ループ |
footnote=y | 各データポイントにfootnoteフィールドを追加 |
1回の呼び出しで複数の指標を取得するには、明示的なソースが必要です:
/country/BR/indicator/NY.GDP.MKTP.CD;SP.POP.TOTL?source=2&format=json
(ソース2 = World Development Indicators、最も一般的な系列をホスト)。
最もよく使われる指標コード(すべてライブで検証済み)
| コード | 指標 |
|---|---|
NY.GDP.MKTP.CD | GDP(現在の米ドル) |
NY.GDP.MKTP.KD.ZG | GDP成長率(年率 %) |
NY.GDP.PCAP.CD | 1人当たりGDP(現在の米ドル) |
NY.GNP.PCAP.CD | 1人当たりGNI(アトラス方式、現在の米ドル) |
SP.POP.TOTL | 総人口 |
FP.CPI.TOTL.ZG | インフレ率、消費者物価(年率 %) |
SL.UEM.TOTL.ZS | 失業率(労働力人口の%、ILO) |
SP.DYN.LE00.IN | 出生時の平均余命(年) |
SI.POV.GINI | ジニ係数 |
SI.POV.DDAY | 1日3.00ドル未満の貧困率(人口の%) |
EN.GHG.CO2.PC.CE.AR5 | 1人当たりCO2排出量(t CO2e) |
IT.NET.USER.ZS | インターネット利用者(人口の%) |
NE.EXP.GNFS.ZS | 財・サービスの輸出(GDPの%) |
BX.KLT.DINV.WD.GD.ZS | FDI純流入(GDPの%) |
PA.NUS.FCRF | 公式為替レート(1米ドルあたりの現地通貨) |
SP.URB.TOTL.IN.ZS | 都市人口(総人口の%) |
トピック別にグループ化されたさらに100以上の検証済みコードはreferences/indicators.mdにあります — 必要な系列がこの表にない場合は、それを読んでください。キーワードで検索するには、スクリプトの--searchまたはreferences/endpoints.mdの検索エンドポイントを使用してください(APIにはサーバー側のテキスト検索はありません)。
国コードと集計
国: ISO-2(US)またはISO-3(USA)の両方が機能します。知っておくべき集計:
WLD 世界、EUU 欧州連合、EMU ユーロ圏、HIC/UMC/LMC/LIC 所得グループ、EAS 東アジア・太平洋、ECS ヨーロッパ・中央アジア、LCN ラテンアメリカ・カリブ海、MEA 中東・北アフリカ、SAS 南アジア、SSF サハラ以南アフリカ、NAC 北アメリカ。
country/allは経済圏と集計が混在して返されます(年間265行)。実際の国だけを保持するには、/v2/country?format=json&per_page=400を1回取得し、region.value == "Aggregates"のエントリを削除します。
国のメタデータ(地域、所得レベル、首都、座標):
GET https://api.worldbank.org/v2/country/JPN?format=json
GET https://api.worldbank.org/v2/country?incomeLevel=LIC&format=json&per_page=100
コード例
import requests
def wb_series(indicator: str, countries: str = "all", **params) -> list[dict]:
"""World Bankの系列を取得;フラットなデータポイントのリストを返す。"""
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]: # APIエラーは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);
エラー
エラーはHTTP 200としてメッセージエンベロープとともに返されます — 常にチェックしてください:
[{"message": [{"id": "120", "key": "Invalid value",
"value": "The provided parameter value is not valid"}]}]
120— 無効な国または指標コード(World Bankがカバーしていない経済圏、例えば台湾にはどのコードでもデータがない場合にも返されます)。175— 指標は存在するが、そのデータは削除またはアーカイブされています(例:古いCO2系列EN.ATM.CO2E.PC→EN.GHG.*の代替を使用;Doing Businessソース全体がアーカイブされています)。後継コードを検索してください。- 時折、JSONの代わりに一時的なHTMLの「Request Error」ページが返される場合があります — 失敗とみなす前に1回再試行してください。
実用的なヒント
- 「最新の数値」には
mrv=1よりもmrnev=1を優先してください — ほとんどの系列は1〜2年遅れるため、mrv=1はvalue: nullの最新年を返すことがよくあります。 per_pageを高く設定し(例:20000)、ページネーションはほとんど不要になります。all国×1年はわずか265行です。- メタデータの
totalは、null値を含む国×期間のスロットをカウントします。 - ローカライズされた名前:
/v2の後に言語コードを挿入 —/v2/zh/country/CN/indicator/...(対応言語:en、es、fr、ar、zh)。ラベルのみが翻訳され、コードと値は同一です。 - データの改訂はほぼ毎月行われます。メタデータの
lastupdatedがソースの更新日を示します。 - 年次が標準です。月次/四半期はごく一部のソース(Global Economic Monitor
source=15、四半期債務source=20/22/23)にのみ存在します —references/endpoints.mdを参照してください。
完全なエンドポイントカタログ(指標リスト、トピック、ソース、地域、所得レベル、貸付タイプ、言語、月次/四半期データ)についてはreferences/endpoints.mdを読み、トピック別のさらに100以上の検証済み指標コードについてはreferences/indicators.mdをお読みください。