25:["$","title",null,{"children":"Accès aux indices et séries chronologiques via un service web respectant la norme SDMX | Benjamin Picod | Observable"}] 49:T9c6,

Présentation du service

Ce service web de type REST permet d’accéder aux séries chronologiques mises à disposition sur le site insee.fr sous une forme structurée. Il respecte la norme SDMX. Ce service est mis à disposition selon deux canaux :

directement à l’adresse https://bdm.insee.fr. Le service n'est accessible que par une requête HTTPS ;
par le portail des API de l’Insee, accessible à l’adresse https://api.insee.fr, en procédant à une inscription.

Dans la suite de ce document, les requêtes commencent par le radical https://bdm.insee.fr/series/sdmx/ pour permettre une illustration rapide par des exemples concrets. Dans le cadre de l’utilisation via le portail des API, les instructions à considérer sont celles après le radical, par exemple pour l’accès aux séries par leur identifiant :

Par interrogation directe HTTPS dans un navigateur internet https://bdm.insee.fr/series/sdmx/data/SERIES_BDM/idbanks?parametresFacultatifs
Depuis la page Console de l’API, sur api.insee.fr

Les indices et séries chronologiques présentent divers types d’indicateurs (court terme, structurel, spécifique, etc.) relatifs à la France et notamment un ensemble de séries longues. Un indicateur se décompose en autant de séries élémentaires qu’il y a de croisements de variables possibles. Par exemple, 50 secteurs d’activité x 2 périodicités [mensuelle et trimestrielle] x 2 corrections [brute et cvs] = 200 séries diférentes accessibles par le service web. Pour chaque série, il est possible d’obtenir la valeur la plus récente mais aussi des données historiques avec une profondeur variable selon le type d’indicateurs.

Le service web SDMX permet un accès :

aux valeurs des séries ;
aux métadonnées structurelles décrivant les caractéristiques des séries ;
au calendrier de mise à jour des indicateurs auxquels appartiennent les séries ;

est gratuit ;

impose des limites sur la quantité d’informations récupérables en une seule requête pour ne pas surcharger le serveur et pénaliser les autres utilisateurs.

4a:T5ad,

A propos de SDMX

Le standard SDMX 2.1 (http://sdmx.org/?page_id=5008) fournit une norme précise et complète de structuration de données et métadonnées statistiques, ainsi qu’une description de services web REST permettant d’y accéder : elle sera respectée autant que possible par ce service web.

SDMX est un standard international qui a été adopté par les principaux producteurs de statistiques officielles (Eurostat, OCDE, FMI, Banque Mondiale, Nations Unies…). Il est également utilisé par un nombre croissant d’instituts nationaux de statistiques (Insee, Istat…).

SDMX permet de décrire les données et les métadonnées statistiques de manière structurée et standardisée. Il facilite ainsi l’échange et la diffusion des données entre les producteurs et les utilisateurs de statistiques.

SDMX repose sur un ensemble de concepts et de modèles qui permettent de définir les caractéristiques des données et des métadonnées statistiques. Il définit également des formats d’échange basés sur XML (eXtensible Markup Language) pour représenter les données et les métadonnées.

SDMX propose enfin une architecture de services web REST (Representational State Transfer) qui permet d’accéder aux données et aux métadonnées statistiques via des requêtes HTTP (Hypertext Transfer Protocol). Ces requêtes sont construites à partir des concepts et des modèles SDMX.

4b:T95b,

I - Utilisation du service

Ce service web de type REST permet d’accéder aux séries chronologiques mises à disposition sur le site insee.fr sous une forme structurée. Il respecte la norme SDMX.

Ce service est mis à disposition selon deux canaux :

directement à l’adresse https://bdm.insee.fr. Le service n'est accessible que par une requête HTTPS ;
par le portail des API de l’Insee, accessible à l’adresse https://api.insee.fr, en procédant à une inscription.

Dans la suite de ce document, les requêtes commencent par le radical https://bdm.insee.fr/series/sdmx / pour permettre une illustration rapide par des exemples concrets. Dans le cadre de l’utilisation via le portail des API, les instructions à considérer sont celles après le radical, par exemple pour l’accès aux séries par leur identifiant :

Par interrogation directe HTTPS dans un navigateur internet https://bdm.insee.fr/series/sdmx/data/SERIES_BDM/idbanks ?parametresFacultatifs
Depuis la page Console de l’API, sur api.insee.fr /data/SERIES_BDM/idbanks ?parametresFacultatifs

Les indices et séries chronologiques présentent divers types d’indicateurs (court terme, structurel, spécifique, etc.) relatifs à la France et notamment un ensemble de séries longues.

Un indicateur se décompose en autant de séries élémentaires qu’il y a de croisements de variables possibles. Par exemple, 50 secteurs d’activité x 2 périodicités [mensuelle et trimestrielle] x 2 corrections [brute et cvs] = 200 séries diférentes accessibles par le service web.

Pour chaque série, il est possible d’obtenir la valeur la plus récente mais aussi des données historiques avec une profondeur variable selon le type d’indicateurs.

Le service web SDMX permet un accès :

aux valeurs des séries ;
aux métadonnées structurelles décrivant les caractéristiques des séries ;
au calendrier de mise à jour des indicateurs auxquels appartiennent les séries ;

Ce service web :

est gratuit ;
impose des limites sur la quantité d’informations récupérables en une seule requête pour ne pas surcharger le serveur et pénaliser les autres utilisateurs.

II - Accès simplifié aux séries par leur idbank h1 { font-family: Arial, sans-serif; font-size: 18px; font-weight: bold; text-align: center; } h2 { font-family: Arial, sans-serif; font-size: 16px; font-weight: bold; text-align: left; } p { font-family: Arial, sans-serif; font-size: 14px; text-align: justify; } ul { font-family: Arial, sans-serif; font-size: 14px; } li { margin-bottom: 10px; }

Contenu de la réponse

La réponse est structurée selon le standard SDMX et contient :

les valeurs des séries demandées ;
les métadonnées structurelles décrivant les caractéristiques des séries ;
les métadonnées de référence décrivant les concepts utilisés pour les séries.

La réponse peut être obtenue dans diférents formats :

XML (par défaut) : https://bdm.insee.fr/series/sdmx/data/SERIES_BDM/001565137+001585934
JSON : https://bdm.insee.fr/series/sdmx/data/SERIES_BDM/001565137+001585934?format=sdmx-json
CSV : https://bdm.insee.fr/series/sdmx/data/SERIES_BDM/001565137+001585934?format=csv

Forme de la requête

4d:Ta5c,

Dix attributs décrivent les séries :

l’identifiant de la série (idbank) ;
le titre de la série ;
la périodicité de la série ;
la date de début de la série ;
la date de fin de la série ;
le nombre d’observations dans la série ;
la date de dernière mise à jour de la série ;
le statut de la série (provisoire ou définitif) ;
le type d’indicateur auquel appartient la série ;
le lien vers le calendrier de mise à jour de l’indicateur auquel appartient la série.

Valeur de l’observation

Pour chaque observation d’une série sont fournis :

la valeur numérique ;
la période à laquelle se rapporte l’observation ;
un attribut indiquant si l’observation est provisoire ou définitive.

Lorsque l’observation n’est pas disponible, une valeur manquante est renvoyée. Dans ce cas, un attribut indique le motif de non-disponibilité :

Motif	Description
A	Valeur non disponible car non applicable (par exemple : indice trimestriel pour un mois donné)
B	Valeur non disponible car non observée (par exemple : indice annuel pour une année incomplète)
C	Valeur non disponible car confidentielle (par exemple : indice pour un secteur d’activité trop peu représenté)
D	Valeur non disponible car en attente de publication (par exemple : indice mensuel pour le mois en cours)
E	Valeur non disponible car en cours d’estimation (par exemple : indice trimestriel pour le trimestre en cours)
F	Valeur non disponible car en cours de révision (par exemple : indice annuel révisé après publication)
G	Valeur non disponible car en cours d’évaluation (par exemple : indice mensuel provisoire soumis à validation)
H	Valeur non disponible car hors champ (par exemple : indice pour une modalité inexistante)

4e:T5dc,

Dix attributs décrivent les séries :

Identifiant des attributs	Description	Format
IDBANK	Identifiant de la série	9 chiffres : 000639196
FREQ	Périodicité	Une lettre : A, T, M, B ou S
TITLE_FR	Libellé français	240 caractères maximum
TITLE_EN	Libellé anglais	240 caractères maximum
LAST_UPDATE	Date de dernière mise à jour	aaaa-mm-jj
UNIT_MEASURE	Unité	12 caractères maximum
UNIT_MULT	Puissance	Nombre compris entre 0 et 9
REF_AREA	Zone géographique	12 caractères maximum
DECIMALS	Nombre de décimales	Nombre compris entre 0 et 9
BASE_PER	Base de l'indice	Période : 2010 ou 2008-T4 par exemple

4f:T4ef,

Sept caractéristiques décrivent les observations :

Périodicité	Format	Exemple	Signification
Annuelle	AAAA	2013	Année 2013
Trimestrielle	AAAA-Qn	2014-Q3	Troisième trimestre de l'année 2014
Mensuelle	AAAA-nn	1990-09	Septembre 1990
Bimestrielle	AAAA-Bn	2010-B4	4ème bimestre sur 6 de l'année 2010, soit la période comprise entre le 01/07/2010 et le 31/08/2010
Semestrielle	AAAA-Sn	2012-S2	2ème semestre de l'année 2012, soit la période comprise entre le 01/07/2012 et le 31/12/2012

50:T763,

L’attribut OBS_STATUS est toujours présent et décrit la qualité des valeurs sous la forme suivante :
- A : valeur définitive
- P : provisoire
- SD : semi-définitive
- R : révisée
- E : estimée
- O : manquante
L'attribut OBS_QUAL est toujours présent et décrit la qualité des valeurs sous la forme suivante :
- E : estimation
- P : valeur provisoire
- SD : valeur semi-définitive
- DEF : valeur définitive
- F : prévision
L'attribut OBS_TYPE est toujours présent et décrit la qualité des valeurs sous la forme suivante :
- A : normale
- U : atypique
- O : manquante
- ND : non disponible
- N : non significative
L'attribut OBS_CONF est facultatif et décrit la confidentialité des valeurs sous la forme suivante :
- C : valeur confidentielle
- Q : couverte par le secret statistique
L'attribut OBS_REV est facultatif et décrit le caractère de révision des valeurs sous la forme suivante :
- 1 : révision
L’attribut DATE_JO est facultatif, il est ajouté lorsqu’une valeur est publiée au Journal Ofciel de la République Française (journal-ofciel.gouv.fr). Il a la forme "aaaa-mm-jj", soit par exemple "2016-04-14".

51:T428,Styles.css :p 52:[] 29:{"id":"eccc83ff61a4d439","slug":null,"title":"Accès aux indices et séries chronologiques via un service web respectant la norme SDMX","thumbnail":"e69eee0c8c9d10a16248cee0882b74837b005c7269baa68f086eac377c09c05f","access_level":"public","create_time":"$D2023-05-09T06:41:22.421Z","update_time":"$D2023-05-10T06:35:17.964Z","view_time":null,"first_public_time":"$D2023-05-09T06:41:22.421Z","has_unpublished_edits":null,"fork":false,"stars":0,"starred":false,"owner":{"type":"team","id":"76739ff3d068a96c","login":"bpicod","name":"Benjamin Picod","avatar_url":"https://avatars-next.observableusercontent.com/6b375e8997394156ec3faf704d4b2748e1fed2651347f717e3e5988f3e84164a","tier":"starter_2024","bio":"Webmaster for INSEE (French National Institute of Statistics and Economic Analysis). Interested in web based datavisualisation, libraries and tools.","following":false},"version":68,"publish_version":null,"role":null,"authored":false,"authors":[{"type":"individual","id":"b0047ee932812541","login":"bpicod","name":"Benjamin Picod","avatar_url":"https://avatars-next.observableusercontent.com/6b375e8997394156ec3faf704d4b2748e1fed2651347f717e3e5988f3e84164a","tier":null,"bio":"Webmaster for INSEE (French National Institute of Statistics and Economic Analysis). Interested in web based datavisualisation, libraries and tools.","following":false}],"members":[{"type":"individual","id":"b0047ee932812541","login":"bpicod","name":"Benjamin Picod","avatar_url":"https://avatars-next.observableusercontent.com/6b375e8997394156ec3faf704d4b2748e1fed2651347f717e3e5988f3e84164a","tier":null,"role":"editor"}],"comments":[],"custom_thumbnail":false,"trashed":false,"lapsed":null,"subscribed":null,"forks":0,"collection":null,"type":"notebook","body":{"titling":"auto","title":"Accès aux indices et séries chronologiques via un service web respectant la norme SDMX","cells":[{"id":27,"value":"

Accès aux indices et séries chronologiques via un service web respectant la norme SDMX

Service web pour les indices et séries chronologiques

Guide d’utilisation

Juin 2020

Accès aux indices et séries chronologiques via un service web respectant la norme SDMX v 2.2

Historique des versions successives

\n\n\n\n\n\n

N°	Date	Modifications
2.0	15/06/2017
2.1	04/10/2017	Ajout de la fonction d’historisation des publications pour certaines séries
2.2	03/06/2020	Adaptation pour la mise en ligne sur le portail api.insee.fr et corrections mineures

","pinned":false,"hidden":false,"mode":"html","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":29,"value":"$49","pinned":false,"hidden":false,"mode":"html","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":44,"value":"$4a","pinned":false,"hidden":false,"mode":"html","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":48,"value":"$4b","pinned":false,"hidden":false,"mode":"html","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":53,"value":"$4c","pinned":false,"hidden":false,"mode":"html","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":55,"value":"$4d","pinned":false,"hidden":false,"mode":"html","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":62,"value":"$4e","pinned":false,"hidden":false,"mode":"html","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":65,"value":"$4f","pinned":false,"hidden":false,"mode":"html","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":67,"value":"$50","pinned":false,"hidden":false,"mode":"html","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":22,"value":"$51","pinned":false,"hidden":false,"mode":"html","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"}],"files":"$W52","stdlib":"1"}} 24:null