API リファレンス
プラットフォーム全体で一つの REST API。JSON のみ、バージョン管理は次の下で行われます /api/v1.
認証
アカウントページでキーを作成し、bearer トークンとして送信してください。キーは無償です。
curl -H "Authorization: Bearer ec_ab12cd34.YOUR_SECRET" \ "https://mondo.international/api/v1/datasets"
ヘッダーを設定できないツールのために、X-API-Key と ?api_key= も受け付けます。
認可を決めるのはライセンスであり、キーではありません
有効なキーがあればカタログを取得できます。観測値が提供されるのは、申告した用途についてライセンスに同意済みのデータセットに限られます。未同意の場合、API は 403 を返し、必要なライセンスと同意用のリンクを示します。
{
"error": {
"code": "licence_acceptance_required",
"message": "You have not accepted the licence terms for the requested data...",
"declined": [{"dataset": "wb-trade-openness", "licence": {"code": "CC-BY-4.0"}, ...}],
"accept_at": "https://mondo.international/account/"
}
}
エンドポイント
| エンドポイント | スコープ | 返される内容 |
|---|---|---|
| GET /api/v1/ | — | サービスの説明とエンドポイント一覧 |
| GET /api/v1/meta | — | 言語、制限、行数 |
| GET /api/v1/licences | — | 機械可読なライセンス登録簿 |
| GET /api/v1/sources | — | 提供元とその利用条件 |
| GET /api/v1/questions | — | 問いを起点としたナビゲーションのデータ表現 |
| GET /api/v1/datasets | catalog:read | カタログ。データセットごとのアクセス判定つき |
| GET /api/v1/datasets/<slug> | catalog:read | 一つのデータセットと、その指標および鮮度 |
| GET /api/v1/areas | catalog:read | ISO コードつきの地域 |
| GET /api/v1/observations | data:read | データ本体。ライセンスによる制御あり。 |
| GET /api/v1/search | catalog:read | 検索語に一致する問い・データセット・指標・地域 |
| GET /api/v1/freshness | catalog:read | 各データセットの最終更新時点と、鮮度切れかどうか |
| GET /api/v1/publications | catalog:read | Mondoの引用方法と、その背景にある研究 |
観測値の照会
| パラメータ | 例 | 備考 |
|---|---|---|
| dataset | wb-trade-openness | スラッグ。これか indicator のいずれかが必須です。 |
| indicator | NE.TRD.GNFS.ZS,NE.EXP.GNFS.ZS | カンマ区切りの出典コード |
| area | CAN,FRA,JPN,CHN | ISO-3、ISO-2、NUTS または集計コード |
| partner | USA | 二国間系列のみ |
| start / end | 2000 / 2024 | 年 (両端を含む) |
| use | commercial | このリクエストで申告する用途。ライセンスが許可するものに限ります |
| limit / offset | 5000 / 0 | 最大 50000 |
| lang | fr | en, fr, ja, zh |
試す
curl -H "Authorization: Bearer $EC_KEY" \ "https://mondo.international/api/v1/observations?dataset=abs-national-accounts&area=CAN,FRA,JPN&start=2010" curl -H "Authorization: Bearer $EC_KEY" \ "https://mondo.international/api/v1/observations?dataset=bis-policy-rates&area=CAN,FRA,JPN&start=2010" curl -H "Authorization: Bearer $EC_KEY" \ "https://mondo.international/api/v1/observations?dataset=ecb-hicp-inflation&area=CAN,FRA,JPN&start=2010"
レスポンスの形
{
"count": 45,
"declared_use": "academic",
"licences": { "CC-BY-4.0": { "name": "...", "attribution": "..." } },
"citation": ["Mondo (2026). Trade openness... Licence: CC BY 4.0."],
"observations": [
{ "dataset": "wb-trade-openness", "indicator": "NE.TRD.GNFS.ZS",
"area": "CAN", "partner": null, "period": "2024-12-31",
"value": 67.4, "unit": null, "status": null }
]
}
何を引用するか
データを含む回答には、必ず二つのものが付きます。一つ目のcitationとlicencesは提供元とライセンスを示すもので、ほとんどのライセンスがこの表示を求めています。二つ目のciteはお願いです。プラットフォーム自体の参考文献と、求められたデータに最も近い、科学ディレクターによる公刊論文を最大4点、それぞれDOI付きで示します。Mondoが公表される成果の役に立った場合は、プラットフォームを引用していただければ幸いです。関連研究も、主題に関係する場合にはあわせて引用をご検討ください。これは利用条件ではありません。
"cite": {
"platform": "Warin, T. (2026). Mondo: open international economic data [Data platform]. CIRANO. https://mondo.international",
"related_research": [
{ "reference": "Van Assche, A., & Warin, T. (2019). Global Value Chains and Economic Diplomacy. AIB Insights. https://doi.org/...",
"doi": "...", "url": "https://doi.org/...", "year": 2019 }
],
"all_publications": "https://mondo.international/publications"
}
AIアシスタント向けMCPサーバー
同じAPIを、Model Context Protocolを通じてAIアシスタントにも提供しています。接続したアシスタントは、ツールとしてカタログを検索し、データを読むことができます。それ以外は何も変わりません。同じキー、同じ制限、同じライセンスゲートが適用され、すべての回答に引用とライセンスが付きます。
https://mondo.international/mcp
トランスポート:Streamable HTTP、JSON応答、セッションなし。REST APIと同じく、キーをBearerトークンとして送信してください。サーバーの説明の取得にキーは不要ですが、ツールの呼び出しには必要です。
claude mcp add --transport http mondo https://mondo.international/mcp \ --header "Authorization: Bearer ec_ab12cd34.YOUR_SECRET"
| ツール | 返される内容 |
|---|---|
| search | 検索語に一致する問い・データセット・指標・地域 |
| list_questions | 問いを起点としたナビゲーションのデータ表現 |
| list_datasets | カタログ。データセットごとのアクセス判定つき |
| get_dataset | 一つのデータセットと、その指標および鮮度 |
| list_areas | ISO コードつきの地域 |
| get_observations | データ本体。ライセンスによる制御あり。 |
| list_sources | 提供元とその利用条件 |
| list_licences | 機械可読なライセンス登録簿 |
| how_to_cite | Mondoの引用方法と、その背景にある研究 |
| data_freshness | 各データセットの最終更新時点と、鮮度切れかどうか |
アシスタントは受け取った行をすべて読むため、get_observationsが返すのは1回の呼び出しにつき最大2,000行です。続きはoffsetで取得するか、一括ダウンロードにはREST APIを使ってください。
誰が利用できるか
匿名利用の枠はありません。このサービス説明を除くすべてのエンドポイントにキーが必要であり、キーはアカウントのアドレス宛に送られたリンクをクリックして確認されて初めて機能します。人間にとっては1クリックの手間ですが、スクリプトにとっては欲しいキーの数だけ実際に使えるメールボックスが必要になります。それが狙いです。
データを有償にするための仕組みではありません。データもキーも無償です。何か問題が起きたときに連絡が取れる人にAPIを使ってもらうため、そしてあなたに代わって条件に同意した提供元にとっての匿名の中継地点にならないためです。
制限
既定 60/minute. 各キーには月間上限もあり、アカウントページで確認できます。足りなければお申し出ください。このプラットフォームの目的は、あなたにデータを使ってもらうことです。