mondo.international

Référence de l’API

Une seule API REST pour toute la plateforme. JSON uniquement, versionnée sous /api/v1.

Authentification

Créez une clé sur votre page de compte, puis envoyez-la comme jeton bearer. Les clés sont gratuites.

curl -H "Authorization: Bearer ec_ab12cd34.YOUR_SECRET" \
  "https://mondo.international/api/v1/datasets"

X-API-Key et ?api_key= sont également acceptés, pour les outils qui ne peuvent pas définir d'en-têtes.

C'est la licence qui autorise, pas la clé

Une clé valide vous donne le catalogue. Les observations ne sont servies que pour les jeux de données dont vous avez accepté la licence pour l'usage que vous déclarez. À défaut, l'API renvoie un 403 précisant la licence exacte qu'il vous faut, avec un lien pour l'accepter.

{
  "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/"
  }
}

Points d'accès

Point d'accèsPortéeCe qu'il renvoie
GET /api/v1/—Description du service et index des points d'accès
GET /api/v1/meta—Langues, limites, nombres de lignes
GET /api/v1/licences—Le registre des licences, lisible par machine
GET /api/v1/sources—Les fournisseurs et leurs conditions
GET /api/v1/questions—La navigation par questions, sous forme de données
GET /api/v1/datasetscatalog:readLe catalogue, avec votre décision d'accès pour chaque jeu de données
GET /api/v1/datasets/<slug>catalog:readUn jeu de données, avec ses indicateurs et sa fraîcheur
GET /api/v1/areascatalog:readLes géographies avec leurs codes ISO
GET /api/v1/observationsdata:readLes données. Sous contrôle de licence.
GET /api/v1/searchcatalog:readQuestions, jeux de données, indicateurs et territoires correspondant à une recherche
GET /api/v1/freshnesscatalog:readLa date du dernier rafraîchissement de chaque jeu de données, et s'il est périmé
GET /api/v1/publicationscatalog:readComment citer Mondo, et la recherche qui le sous-tend

Interroger les observations

ParamètreExempleNotes
datasetwb-trade-opennessIdentifiant court. Celui-ci ou « indicator » est requis.
indicatorNE.TRD.GNFS.ZS,NE.EXP.GNFS.ZSCodes de source séparés par des virgules
areaCAN,FRA,JPN,CHNCodes ISO-3, ISO-2, NUTS ou codes d'agrégats
partnerUSAPour les séries bilatérales uniquement
start / end2000 / 2024Années, bornes comprises
usecommercialUsage déclaré pour cette requête ; doit être permis par la licence
limit / offset5000 / 0Max 50000
langfren, fr, ja, zh

Essayer

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"

Forme de la réponse

{
  "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 }
  ]
}

Que citer

Chaque réponse qui contient des données contient aussi deux choses. La première, citation et licences, nomme le fournisseur et la licence : la plupart des licences exigent cette attribution. La seconde, cite, est une demande : une référence pour la plateforme elle-même et jusqu'à quatre travaux publiés de son directeur scientifique, les plus proches des données demandées, chacun avec son DOI. Si Mondo a soutenu un travail que vous publiez, citer la plateforme est apprécié, ainsi que les travaux liés lorsqu'ils sont pertinents pour votre sujet. Ce n'est pas une condition d'utilisation.

"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"
}

Serveur MCP, pour les assistants d'IA

La même API est offerte aux assistants d'IA par le Model Context Protocol. Un assistant qui s'y connecte peut chercher dans le catalogue et lire les données sous forme d'outils, et rien d'autre ne change : la même clé, les mêmes limites et le même contrôle des licences s'appliquent, et chaque réponse porte sa citation et sa licence.

https://mondo.international/mcp

Transport : Streamable HTTP, réponses JSON, sans session. Envoyez votre clé comme jeton bearer, comme pour l'API REST. Décrire le serveur ne demande pas de clé ; appeler un outil, si.

claude mcp add --transport http mondo https://mondo.international/mcp \
  --header "Authorization: Bearer ec_ab12cd34.YOUR_SECRET"
OutilCe qu'il renvoie
searchQuestions, jeux de données, indicateurs et territoires correspondant à une recherche
list_questionsLa navigation par questions, sous forme de données
list_datasetsLe catalogue, avec votre décision d'accès pour chaque jeu de données
get_datasetUn jeu de données, avec ses indicateurs et sa fraîcheur
list_areasLes géographies avec leurs codes ISO
get_observationsLes données. Sous contrôle de licence.
list_sourcesLes fournisseurs et leurs conditions
list_licencesLe registre des licences, lisible par machine
how_to_citeComment citer Mondo, et la recherche qui le sous-tend
data_freshnessLa date du dernier rafraîchissement de chaque jeu de données, et s'il est périmé

Un assistant lit chaque ligne qu'il reçoit : get_observations renvoie donc au plus 2 000 lignes par appel ; utilisez offset pour la suite, ou l'API REST pour les téléchargements en masse.

Qui peut l'appeler

Il n'existe pas de palier anonyme. Chaque point d'accès, hormis cette description du service, exige une clé, et une clé ne fonctionne qu'une fois l'adresse du compte confirmée en cliquant sur un lien qui y est envoyé. Cela coûte un clic à une personne ; cela coûte à un script une boîte aux lettres fonctionnelle par clé, ce qui est précisément le but.

Il ne s'agit pas de faire payer les données. Les données sont gratuites et les clés aussi. Il s'agit de faire en sorte que l'API soit utilisée par des personnes que nous pouvons joindre en cas de problème, et de ne pas devenir un relais anonyme pour des fournisseurs dont nous avons accepté les conditions en votre nom.

Limites

Par défaut 60/minute. Chaque clé porte aussi un quota mensuel, visible sur votre page de compte. Demandez-en davantage s'il vous en faut : l'objet de cette plateforme est que vous utilisiez les données.