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ès | Portée | Ce 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/datasets | catalog:read | Le catalogue, avec votre décision d'accès pour chaque jeu de données |
| GET /api/v1/datasets/<slug> | catalog:read | Un jeu de données, avec ses indicateurs et sa fraîcheur |
| GET /api/v1/areas | catalog:read | Les géographies avec leurs codes ISO |
| GET /api/v1/observations | data:read | Les données. Sous contrôle de licence. |
| GET /api/v1/search | catalog:read | Questions, jeux de données, indicateurs et territoires correspondant à une recherche |
| GET /api/v1/freshness | catalog:read | La date du dernier rafraîchissement de chaque jeu de données, et s'il est périmé |
| GET /api/v1/publications | catalog:read | Comment citer Mondo, et la recherche qui le sous-tend |
Interroger les observations
| Paramètre | Exemple | Notes |
|---|---|---|
| dataset | wb-trade-openness | Identifiant court. Celui-ci ou « indicator » est requis. |
| indicator | NE.TRD.GNFS.ZS,NE.EXP.GNFS.ZS | Codes de source séparés par des virgules |
| area | CAN,FRA,JPN,CHN | Codes ISO-3, ISO-2, NUTS ou codes d'agrégats |
| partner | USA | Pour les séries bilatérales uniquement |
| start / end | 2000 / 2024 | Années, bornes comprises |
| use | commercial | Usage déclaré pour cette requête ; doit être permis par la licence |
| limit / offset | 5000 / 0 | Max 50000 |
| lang | fr | en, 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"
| Outil | Ce qu'il renvoie |
|---|---|
| search | Questions, jeux de données, indicateurs et territoires correspondant à une recherche |
| list_questions | La navigation par questions, sous forme de données |
| list_datasets | Le catalogue, avec votre décision d'accès pour chaque jeu de données |
| get_dataset | Un jeu de données, avec ses indicateurs et sa fraîcheur |
| list_areas | Les géographies avec leurs codes ISO |
| get_observations | Les données. Sous contrôle de licence. |
| list_sources | Les fournisseurs et leurs conditions |
| list_licences | Le registre des licences, lisible par machine |
| how_to_cite | Comment citer Mondo, et la recherche qui le sous-tend |
| data_freshness | La 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.