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.

L'API renvoie les fiches et les fichiers complets. Pour filtrer les données elles-mêmes (une commune, une année…), téléchargez le fichier puis filtrez-le dans votre outil (Python, R, Excel…).

Démarrage rapide

1

Lister les jeux de données

GET /api/datasets/ renvoie tous les jeux publiés avec leur identifiant.

2

Choisir un jeu

Filtrez par catégorie ou lisez la fiche d'un jeu avec son identifiant.

3

Télécharger le fichier

GET /api/datasets/{id}/download renvoie le fichier, prêt à être lu.

Routes disponibles

GET /api/datasets/

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)
Exemple de réponse (abrégé) :
{
  "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/…"
    }
  ]
}
GET /api/datasets/{id}

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).

GET /api/datasets/{id}/download

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
idIdentifiant unique du jeu
title, descriptionTitre et description (en français)
categoryCodes 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
organizationOrganisation productrice
format, file_name, file_sizeFormat, nom et taille du fichier (en octets)
licenseLicence de réutilisation
tagsMots-clés
downloads, viewsNombre de téléchargements et de consultations
created_at, updated_atDates de publication et de dernière mise à jour (ISO 8601, UTC)
file_urlAdresse 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.

Python
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())
R
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)
JavaScript (Node.js 18+)
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();
cURL
# 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"
Les données sont sous licence CC BY 4.0 : vous pouvez les réutiliser librement, y compris à des fins commerciales, en citant la source. Exemple : « Source : Comores Open Data (comoresopendata.org), Population par commune en série longue ».

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
200Requête réussie
403Filtre réservé à l'administration (par exemple status=pending)
404Jeu de données introuvable
422Paramètre invalide (par exemple limit qui n'est pas un nombre)
429Trop de requêtes : attendez le nombre de secondes indiqué par l'en-tête Retry-After
500Erreur 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.