Volver

Servicio web de Estadísticas (API)

El servicio web JSON (JavaScript Object Notation) que se describe en esta sección permite acceder mediante peticiones URL a toda la información disponible tanto en la sección de Estadísticas del Banco de España como en la aplicación BIESTAbre en nueva ventana.

La estructura de las peticiones a través de URL, y la simplicidad del formato JSON, hacen que este tipo de aplicaciones sean ampliamente utilizadas para ofrecer datos que permiten la explotación automática de la información estadística.

Definición de las peticiones

En este apartado se definen los dos tipos de peticiones que pueden realizarse: último dato y listado de series.

Definición

Esta petición permite conocer el último dato publicado de una o más series. El resultado para cada serie se completa con otras variables como frecuencia, descripción o tendencia.

Petición

https://app.bde.es/bierest/resources/srdatosapp/favoritas?idioma={idioma}&series={listado_series}

donde:

  • idioma: puede tomar los valores es o en, para obtener el resultado en español o inglés respectivamente
  • listado_series: listado de códigos de series separados por coma

Resultado

Es un array o listado de objetos. Los campos de cada objeto son:

  • "serie": código de la serie que aparece en los CSV de series temporales y en la aplicación BIEST
  • "descripcionCorta": descripción corta de la serie
  • "codFrecuencia": frecuencia de la serie. Puede tomar los valores:
    • D: diario
    • M: mensual
    • Q: trimestral
    • A: anual
  • "decimales": número máximo de decimales con que se ofrece el dato
  • "simbolo": símbolo con que se representa el dato
  • "tendencia": tendencia respecto al periodo anterior. Puede tomar los valores:
    • +: si crece
    • -: si decrece
    • =: si se mantiene igual
  • "fechaValor": fecha y hora en formato aaaa-mm-ddThh:mm:ssZ. Nota: según la frecuencia, cada periodo se asocia a las siguientes fechas:
    • Frecuencia diaria (D): la fecha es la de referencia
    • Frecuencia mensual (M): la fecha es el 1 del mes de referencia
    • Frecuencia trimestral (Q): la fecha es el 1 del primer mes del trimestre de referencia. Por ejemplo, 2023-04-01 para el trimestre 2
    • Frecuencia anual (A): la fecha es el 1 de enero del año de referencia
  • "valor": último dato publicado de la serie

Por ejemplo:

Definición

Esta petición permite conocer el detalle de una o varias series completas así como su metainformación.

Petición

https://app.bde.es/bierest/resources/srdatosapp/listaSeries?idioma={idioma}&series={listado_series}&rango={rango_temporal}

donde:

  • idioma: puede tomar los valores es o en, para obtener el resultado en español o inglés respectivamente
  • listado_series: listado de códigos de series separados por coma
  • rango_temporal: puede ser un año o un código que determina un número de meses. Estos varían con la frecuencia de la serie:
    • Frecuencia diaria (D): 3M (últimos 3 meses), 12M y 36M
    • Frecuencia mensual (M): 30M, 60M y MAX (toda la serie)
    • Frecuencia trimestral (Q): 30M, 60M y MAX
    • Frecuencia anual (A): 60M y MAX
    Nota: Si no se especifica el parámetro "rango_temporal", la petición devolverá el menor de los rangos para la frecuencia de la serie (por ejemplo, para la frecuencia mensual: 30M).

Resultado

Es un array o listado de objetos cuyos campos son:

  • "serie": código de la serie que aparece en los CSV de series temporales y en la aplicación BIEST
  • "descripcion": descripción de la serie
  • "descripcionCorta": descripción corta de la serie
  • "codFrecuencia": frecuencia de la serie. Puede tomar los valores:
    • D: diario
    • M: mensual
    • Q: trimestral
    • A: anual
  • "decimales": número máximo de decimales con que se ofrece el dato
  • "simbolo": símbolo con que se representa el dato
  • "informacion": es un listado de metainformación extra en forma de par titulo-descripcion, que se muestra en la pestaña Información de la APP
  • "fechaInicio": corresponde al primer periodo que se tiene para la serie (véase el formato definido para el campo "fechas")
  • "fechaFin": corresponde al último periodo que se tiene para la serie (véase el formato definido para el campo "fechas")
  • "fechas": array con las fechas obtenidas según el rango de la petición. Son fecha y hora en formato aaaa-mm-ddThh:mm:ssZ. Nota: según la frecuencia, cada periodo se asocia a las siguientes fechas:
    • Frecuencia diaria (D): la fecha es la de referencia
    • Frecuencia mensual (M): la fecha es el 1 del mes de referencia
    • Frecuencia trimestral (Q): la fecha es el 1 del primer mes del trimestre de referencia. Por ejemplo, 2023-04-01 para el trimestre 2
    • Frecuencia anual (A): la fecha es el 1 de enero del año de referencia
  • "valores": array con los datos publicados correspondientes a las fechas obtenidas en el campo "fechas", y en el mismo orden

Por ejemplo:

Búsqueda de series

Este apartado permite obtener información de las series disponibles en el servicio web a través del código de serie que aparece tanto en la aplicación BIESTAbre en nueva ventana como en los archivos CSV (o Excel) asociados a los cuadros estadísticos que el Banco de España publica en formato PDF en su sección de Estadísticas.

Introduzca el código de la serie

Contacto

Bocadillos de comunicación

ContactoServicio de información de estadísticas