Aller au contenu

Développeurs

Construire sur le catalogue

Une API REST publique en lecture seule sur chaque jeu de données de la bibliothèque — la même documentation que le site, en JSON.

Démarrage rapide

Votre première requête en une ligne

Cherchez, filtrez par licence et obtenez la documentation complète de n’importe quel jeu de données. Les réponses sont en JSON ; aucune clé n’est requise.

URL de base
https://datazimuts.com
Authentification
Aucune — l’API du catalogue est publique et en lecture seule.
curl
curl "https://datazimuts.com/v1/datasets?q=unemployment&commercial_use=yes&per_page=5"
JavaScript
const res = await fetch("https://datazimuts.com/v1/datasets/facets");
const { sources, tags, commercial_use } = await res.json();
console.log(sources.length, "sources,", commercial_use.yes, "datasets cleared for commercial use");
Python
import requests

BASE = "https://datazimuts.com"
hits = requests.get(f"{BASE}/v1/datasets", params={"q": "inflation", "per_page": 5}).json()
for d in hits["datasets"]:
    print(d["id"], d["rows"], d["commercial_use"])

doc = requests.get(f"{BASE}/v1/datasets/{hits['datasets'][0]['id']}").json()
print([c["name"] for c in doc["schema"]])

Licences

Respectez la licence de chaque jeu de données

Chaque jeu de données porte la licence de son éditeur et une autorisation d’usage commercial. Filtrez avec commercial_use et vérifiez toujours la licence avant réutilisation.

  • yesLa licence permet l’usage commercial (une attribution peut rester requise).
  • unclearLes termes de la licence sont ambigus — vérifiez-les avant tout usage commercial.
  • noLa licence interdit l’usage commercial. La documentation reste ouverte ; les téléchargements renvoient HTTP 403.

Référence

Points d’accès

Générée à partir de la spécification OpenAPI en direct, elle correspond toujours à l’API en service. Les descriptions des points d’accès proviennent de la spécification, en anglais. Testez les requêtes dans la console interactive de l’API

Agents et LLM

Lisible par les machines, dès la conception

  • /llms.txt

    Un index en texte brut de chaque jeu de données avec des liens, selon la convention llms.txt.

  • JSON-LD · Croissant

    Chaque page de jeu de données intègre des métadonnées schema.org Dataset et MLCommons Croissant pour les moteurs de recherche et les outils ML.

  • /openapi.json

    La spécification OpenAPI 3 complète, pour les générateurs de clients et les agents qui utilisent des outils.