mondo.international

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/datasetscatalog:readカタログ。データセットごとのアクセス判定つき
GET /api/v1/datasets/<slug>catalog:read一つのデータセットと、その指標および鮮度
GET /api/v1/areascatalog:readISO コードつきの地域
GET /api/v1/observationsdata:readデータ本体。ライセンスによる制御あり。
GET /api/v1/searchcatalog:read検索語に一致する問い・データセット・指標・地域
GET /api/v1/freshnesscatalog:read各データセットの最終更新時点と、鮮度切れかどうか
GET /api/v1/publicationscatalog:readMondoの引用方法と、その背景にある研究

観測値の照会

パラメータ例備考
datasetwb-trade-opennessスラッグ。これか indicator のいずれかが必須です。
indicatorNE.TRD.GNFS.ZS,NE.EXP.GNFS.ZSカンマ区切りの出典コード
areaCAN,FRA,JPN,CHNISO-3、ISO-2、NUTS または集計コード
partnerUSA二国間系列のみ
start / end2000 / 2024年 (両端を含む)
usecommercialこのリクエストで申告する用途。ライセンスが許可するものに限ります
limit / offset5000 / 0最大 50000
langfren, 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_areasISO コードつきの地域
get_observationsデータ本体。ライセンスによる制御あり。
list_sources提供元とその利用条件
list_licences機械可読なライセンス登録簿
how_to_citeMondoの引用方法と、その背景にある研究
data_freshness各データセットの最終更新時点と、鮮度切れかどうか

アシスタントは受け取った行をすべて読むため、get_observationsが返すのは1回の呼び出しにつき最大2,000行です。続きはoffsetで取得するか、一括ダウンロードにはREST APIを使ってください。

誰が利用できるか

匿名利用の枠はありません。このサービス説明を除くすべてのエンドポイントにキーが必要であり、キーはアカウントのアドレス宛に送られたリンクをクリックして確認されて初めて機能します。人間にとっては1クリックの手間ですが、スクリプトにとっては欲しいキーの数だけ実際に使えるメールボックスが必要になります。それが狙いです。

データを有償にするための仕組みではありません。データもキーも無償です。何か問題が起きたときに連絡が取れる人にAPIを使ってもらうため、そしてあなたに代わって条件に同意した提供元にとっての匿名の中継地点にならないためです。

制限

既定 60/minute. 各キーには月間上限もあり、アカウントページで確認できます。足りなければお申し出ください。このプラットフォームの目的は、あなたにデータを使ってもらうことです。