Introduction
L'API de Comores Open Data donne accès, en JSON, à la liste des jeux de données publiés et à leurs fichiers (CSV, Excel…). Elle est ouverte à tous : aucune clé, aucun compte, aucune inscription. Elle sert à automatiser ce que vous feriez à la main sur le catalogue : trouver un jeu de données, lire sa fiche, télécharger son fichier.
Démarrage rapide
Lister les jeux de données
GET /api/datasets/ renvoie tous les jeux publiés avec leur identifiant.
Choisir un jeu
Filtrez par catégorie ou lisez la fiche d'un jeu avec son identifiant.
Télécharger le fichier
GET /api/datasets/{id}/download renvoie le fichier, prêt à être lu.
Routes disponibles
Liste des jeux de données publiés, du plus récemment mis à jour au plus ancien.
Paramètres (tous optionnels) :
| Paramètre | Type | Description |
|---|---|---|
| category | string | Code de catégorie : demographics, economy, health, education, agriculture, environment, tourism, infrastructure, reference, other |
| organization | string | Organisation productrice (recherche partielle, sans tenir compte des majuscules) |
| skip | integer | Nombre de résultats à sauter, pour la pagination (défaut : 0) |
| limit | integer | Nombre maximum de résultats (défaut : 100) |
{
"total": 11,
"datasets": [
{
"id": "490b2854-…",
"title": "Population par commune en série longue",
"description": "…",
"category": "demographics",
"island": "all",
"organization": "comoresopendata",
"format": "csv",
"file_name": "population_commune_serie_longue.csv",
"file_size": 73337,
"license": "CC BY 4.0",
"tags": ["population", "communes"],
"downloads": 12,
"views": 40,
"created_at": "2026-10-23T09:12:00+00:00",
"updated_at": "2026-10-23T09:12:00+00:00",
"file_url": "https://res.cloudinary.com/…"
}
]
}
Fiche d'un jeu de données (mêmes champs que dans la liste). {id} peut être l'identifiant complet, ses 8 premiers caractères, ou la fin de l'adresse de la page du jeu (par exemple population-par-commune-en-serie-longue-490b2854).
Télécharge le fichier du jeu de données (CSV, Excel…), nommé d'après le titre du jeu. Chaque appel compte comme un téléchargement dans les statistiques publiques du jeu.
Champs d'un jeu de données
| Champ | Description |
|---|---|
| id | Identifiant unique du jeu |
| title, description | Titre et description (en français) |
| category | Codes de catégorie séparés par des virgules ; le premier est la catégorie principale |
| island | « all », ou codes séparés par des virgules : grande-comore, anjouan, moheli |
| organization | Organisation productrice |
| format, file_name, file_size | Format, nom et taille du fichier (en octets) |
| license | Licence de réutilisation |
| tags | Mots-clés |
| downloads, views | Nombre de téléchargements et de consultations |
| created_at, updated_at | Dates de publication et de dernière mise à jour (ISO 8601, UTC) |
| file_url | Adresse de stockage du fichier ; préférez la route /download, qui donne un nom de fichier lisible |
Exemples de code
Ces exemples fonctionnent tels quels : ils récupèrent la population par commune.
import requests
import pandas as pd
BASE_URL = "https://comoresopendata.org/api"
# List the demographic datasets
datasets = requests.get(f"{BASE_URL}/datasets/", params={"category": "demographics"}).json()["datasets"]
for d in datasets:
print(d["id"][:8], d["title"])
# Read one file straight into a table
df = pd.read_csv(f"{BASE_URL}/datasets/490b2854/download")
print(df.head())
library(jsonlite)
base_url <- "https://comoresopendata.org/api"
datasets <- fromJSON(paste0(base_url, "/datasets/?category=demographics"))$datasets
print(datasets[, c("title", "format")])
population <- read.csv(paste0(base_url, "/datasets/490b2854/download"), encoding = "UTF-8")
head(population)
const BASE_URL = "https://comoresopendata.org/api";
async function main() {
const response = await fetch(`${BASE_URL}/datasets/?category=demographics`);
const { total, datasets } = await response.json();
console.log(`${total} datasets`);
datasets.forEach(d => console.log(d.id.slice(0, 8), d.title));
const csv = await (await fetch(`${BASE_URL}/datasets/490b2854/download`)).text();
console.log(csv.split("\n").slice(0, 5).join("\n"));
}
main();
# List the datasets
curl "https://comoresopendata.org/api/datasets/"
# One dataset
curl "https://comoresopendata.org/api/datasets/490b2854"
# Download its file
curl -L -o population_commune.csv "https://comoresopendata.org/api/datasets/490b2854/download"
Limites et bonnes pratiques
- Limite par adresse IP : 120 requêtes par minute pour la liste et les fiches des jeux de données, 30 téléchargements par minute. Au-delà, l'API répond 429 avec un en-tête Retry-After (secondes à attendre). Pas de requêtes en rafale.
- L'API s'utilise depuis un script, un serveur ou un outil comme Python, R ou Excel. Les appels directs depuis le navigateur sur un autre site web ne sont pas autorisés pour l'instant : contactez-nous si vous en avez besoin.
- Téléchargez un fichier une fois et gardez-le en local plutôt que de le retélécharger à chaque exécution : chaque téléchargement est compté.
- Les fichiers peuvent être mis à jour : comparez le champ updated_at pour savoir s'il faut les retélécharger.
Codes d'erreur
| Code | Signification |
|---|---|
| 200 | Requête réussie |
| 403 | Filtre réservé à l'administration (par exemple status=pending) |
| 404 | Jeu de données introuvable |
| 422 | Paramètre invalide (par exemple limit qui n'est pas un nombre) |
| 429 | Trop de requêtes : attendez le nombre de secondes indiqué par l'en-tête Retry-After |
| 500 | Erreur du serveur : réessayez plus tard ou contactez-nous |
Une question ou un besoin particulier (autre format, accès par filtre…) ? Écrivez-nous depuis la page Contact.