Comment utiliser l'API de catalogue des données de la plateforme data.gouv.fr ?
Sep 25, 2025
Problème
Comment connaître de façon programmatique tous les jeux de données (JDD) disponibles sur meteo.data.gouv (çàd le catalogue des données) et obtenir les URL de téléchargement ?
Comment savoir si une ressource a été modifiée et qu'il faut la télécharger à nouveau ?
Solution
Afin de permettre à du code informatique de découvrir, parcourir et télécharger automatiquement les jeux de données disponibles, la DINUM met à disposition sur la plateforme meteo.data.gouv un catalogue des données (au format JSON) via une API.
La documentation de cette API est disponible sous la forme du guide "API de data.gouv.fr".
La partie "référence de l'API" donne l'exhaustivité des appels possibles (~ le vocabulaire et la grammaire de l'API)
Seule la partie "parcours et récupération des données" est utile pour un usager de la plateforme.
La structure d'appel de l'API consiste, selon le besoin du parcours et d'accès à construire des URL sous la forme suivante.
NB : le catalogue est renvoyé au format JSON sous forme de liste paginée dont la taille (20 éléments par défaut) peut être paramétrée dans l'appel (cf § "Pagination").
NB2 : il est possible d'utiliser des identifiants textuels dans les requêtes mais ceux-ci étant sujet à des modifications, il est recommandé d'utiliser les identifiants numériques. Les identifiants peuvent être découverts par exploration, soit du portail data.gouv, soit du catalogue : attribut "slug" pour l'identifiant textuel et attribut "id" pour l'identifiant numérique.
URL | Informations |
|---|---|
| Liste (paginée) des organisations enregistrées sur data.gouv et leurs métadonnées |
| Métadonnées de l'organisation Météo-France |
| Liste (paginée) des jeux de données enregistrés sur data.gouv et leurs métadonnées |
| Métadonnées d'un jeux de données (ici le JDD "données climatologiques de base quotidiennes") |
<url-de-base-datagouv>/datasets/6569b51ae64326786e4e8e1a/resources | Liste (paginée) des ressources du JDD "données clim base quot" et leurs métadonnées |
ou
| Métadonnées d'une ressource (ici "Données quotidiennes RR-T-Vent pour le département 01, sur la période 1852-1949") du JDD "données clim base quot" |
Avec :
<url-de-base-datagouv>= 'https://www.data.gouv.fr/api/1'
Compléments :
pour distinguer les ressources documentaires des données ("fichier principal" sur le portail data.gouv) dans un JDD, il faut utiliser l'attribut "
type" (qui vaudra selon le cas : "documentation" ou "main")l'URL de téléchargement d'une ressource est dans l'attribut "
url"l'attribut "
last_modified" de chaque ressource est mis à jour à chaque fois que les données et/ou les métadonnées de la ressource sont modifiées :
il est alors possible de savoir qu'une ressource doit être téléchargée à nouveau.