Comment utiliser l'API d'exploration des données de la plateforme meteo.data.gouv.fr ?
Sep 25, 2025
Problème
Comment filtrer de façon programmatique une donnée au format tabulaire (CSV) disponible sur meteo.data.gouv et obtenir l'URL de téléchargement ?
Solution
Afin de permettre à du code informatique de filtrer, sélectionner et télécharger automatiquement un ensemble réduit d'une donnée tabulaire disponible, la DINUM met à disposition sur la plateforme data.gouv un explorateur de données (données au format tabulaire CSV) via une API.
La documentation de cette API est disponible sur la page "API tabulaire data.gouv.fr".
Cette API est actuellement annoncée comme étant en version béta.
Elle ne permet que la lecture seule avec des requêtes de type HTTP : GET
Une limite d'appels de 100 rêq / seconde est en place sur l'API.
La structure d'appel de l'API consiste, selon le besoin du parcours et d'accès à construire des URL sous la forme suivante.
La spécification de l'API au format OAS (OpenAPI Specification - ex swagger) est disponible.
NB : la donnée est renvoyée 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
NB2 : il est obligatoire d'utiliser les identifiants numériques des données. Les identifiants peuvent être découverts par exploration, soit du portail data.gouv, soit du catalogue via son API.
Le "/" final des URL de l'API tabulaire est obligatoire, sinon une erreur HTTP "404: Not Found" est affichée
URL | Informations |
|---|---|
| Point d'accès à la ressource. |
| Description générale des lignes et colonnes de la donnée tabulaire : type des colonnes, statistiques selon le type de colonne (min, max, ...). |
| Documentation technique de l'accès à la ressource, avec notamment les possibilités de tris et de filtres : |
| Donnée en tant que telle, paginée et sous-sélectionnée selon les paramètres de filtres et de tris. |
Avec :
<url-de-base-datagouv>= 'https://tabular-api.data.gouv.fr/api'<rid>= identifiant numérique de la donnée d'intérêt
Compléments :
les filtres possibles par colonne sont : sur valeur exacte, sur valeur différente, sur la contenance d'une chaîne de caractères, sur l'appartenance à une liste de valeurs, sur des comparaisons <, <=, > ou >=
les tris possibles par colonne sont : tri ascendant ou descendant
le mécanisme de pagination est expliqué dans le § "La donnée par API" de la documentation de l'API tabulaire.
une combinatoire des filtres dans la requête peut être faite en les accumulant dans la query string. Une logique ET s'applique alors sur tous les filtres pour obtenir l'intersection des données filtrées.
Plus de détail sur la manière de filtrer les données dans le § "La donnée par API" de la documentation de l'API tabulaire.
Pour déterminer l'identifiant numérique de la donné d'intérêt, il est possible de : 
|
Articles connexes