Bibliothèques & API
Toutes les options ci-dessous lisent les mêmes fichiers publiés : les chiffres sont donc identiques, quelle que soit celle que vous utilisez.
API JSON
Une API HTTP en lecture seule, à l'adresse https://dataseries.org. Aucune clé n'est nécessaire.
| Point d'accès | Renvoie |
|---|---|
GET /catalog | la liste complète des jeux de données (identifiant, titre, source, licence, fréquence, période couverte, dernière mise à jour) |
GET /dataset/{id}/meta | les métadonnées d'un jeu de données : dimensions, modalités, libellés, unités, hiérarchie |
GET /series?dataset={id}&dims={spec}&from={date}&to={date} | les séries sélectionnées en JSON par colonnes |
GET /series.csv?dataset={id}&dims={spec}&from={date}&to={date} | la même sélection en CSV au format long (une ligne par observation), lisible par tout outil capable d'ouvrir une URL CSV |
GET /health | l'état du service |
dims sélectionne des modalités dans chaque dimension, séparées par des points-virgules, par exemple structure=gdp;type=nom;seas_adj=csa. Sans dims, vous obtenez le jeu de données entier. from et to sont des dates ISO facultatives.
# Whole catalog curl https://dataseries.org/catalog # SECO GDP, nominal, seasonally adjusted, from 2000 curl "https://dataseries.org/series?dataset=ch_seco_gdp&dims=structure=gdp;type=nom;seas_adj=csa&from=2000-01-01" # A single-series dataset curl "https://dataseries.org/series?dataset=ch_kof_barometer"
La documentation des points d'accès se trouve à /__docs__/, où vous pouvez aussi les essayer. La spécification OpenAPI est disponible à /openapi.json.
R
ds() prend un identifiant de jeu de données et un argument par dimension, et renvoie un data frame avec une colonne Date. ds_catalog() liste les jeux de données, ds_meta() affiche les dimensions et les codes d'un jeu de données, et ds_search() trouve des séries individuelles.
install.packages("dataseries")
library(dataseries)
# SECO GDP, nominal, seasonally adjusted, from 2000
df <- ds("ch_seco_gdp", structure = "gdp", type = "nom", seas_adj = "csa",
from = "2000-01-01")
# A single-series dataset: no dimension arguments
df <- ds("ch_kof_barometer")Python
Le paquet Python offre les mêmes fonctions que le paquet R et renvoie des DataFrames pandas. Les arguments de date s'appellent start et end au lieu de from et to.
pip install dataseries
from dataseries import ds
# SECO GDP, nominal, seasonally adjusted, from 2000
df = ds("ch_seco_gdp", structure="gdp", type="nom", seas_adj="csa",
start="2000-01-01")
# A single-series dataset: no dimension arguments
df = ds("ch_kof_barometer")Autres logiciels
/series.csv renvoie un fichier CSV : tout outil capable d'ouvrir une URL peut donc lire une série directement, avec les mêmes filtres dims, from et to. L'encadré Utiliser cette série de chaque page de jeu de données génère le code correspondant à votre sélection actuelle.
# Stata
import delimited "https://dataseries.org/series.csv?dataset=ch_seco_gdp&dims=structure=gdp;type=nom;seas_adj=csa", clear
# MATLAB
T = readtable("https://dataseries.org/series.csv?dataset=ch_kof_barometer");
# Julia
using CSV, DataFrames, Downloads
df = CSV.read(Downloads.download("https://dataseries.org/series.csv?dataset=ch_kof_barometer"), DataFrame)
# Excel / Power Query: Data > Get Data > From Web, then paste the URL (refreshes in place)
https://dataseries.org/series.csv?dataset=ch_kof_barometer
# SAS
filename ds url "https://dataseries.org/series.csv?dataset=ch_kof_barometer";
proc import file=ds out=work.ds dbms=csv replace; run;
# curl / shell
curl "https://dataseries.org/series.csv?dataset=ch_kof_barometer"Téléchargements
Chaque page de jeu de données permet de télécharger la sélection actuelle, avec la transformation éventuellement appliquée, en CSV, Excel ou JSON, et le graphique en PNG ou SVG. Les fichiers complets de chaque jeu de données (données CSV, métadonnées JSON et une copie Parquet) se trouvent dans le dépôt dataseries-data.
Intégrer des graphiques
Les graphiques peuvent être intégrés dans n'importe quelle page web au moyen d'un iframe. L'onglet Intégrer de l'encadré Utiliser cette série génère le code correspondant à votre sélection actuelle. Les graphiques intégrés se mettent à jour dès que de nouvelles données arrivent.
<iframe src="https://dataseries.org/d/ch_kof_barometer?embed=1" width="100%" height="580" style="border:0;border-radius:12px" loading="lazy" title="KOF Barometer, dataseries.org"> </iframe>