Valores de series de tiempo

GET

https://apis.datos.gob.ar/series/api/series

Obtener valores de una o más series de tiempo a partir de sus identificadores. Permite filtrar por fechas, cambiar intervalos de tiempo y unidades de medida.

Mediante este endpoint se accede a los valores de series usando sus identificadores únicos. Se pueden filtrar datos por período específico, modificar intervalos de tiempo y unidades de medida, entre otras operaciones.

Parámetros

Query Parameters

ids*

Parámetro obligatorio que consiste en el indentificador único de la serie o de las series cuyos valores queremos consultar. Si son varias series, sus ids se deben enlistar separándolos por comas.
Se pueden obtener los ids de las series en la columna 'serie_id' del siguiente csv:
https://apis.datos.gob.ar/series/api/dump/series-tiempo-metadatos.csv. .

Tipostring

Requerido

Ejemplo455.1_ALMACENCEN_0_M_7_95,455.1_CANALES_ONINE_0_M_15_84,455.1_CARNESNES_0_M_6_38,455.1_VERDULERIARIA_0_M_19_68

representation_mode

Consultar la variación de valores de una serie (aumentos o disminuciones periodo a periodo). Opciones disponibles:

• change: mostrar diferencia entre valores consecutivos.
• percentage_change: mostrar diferencia porcentual entre valores consecutivos.
• change_a_year_ago: mostrar diferencia respecto al mismo período del año anterior.
• percentage_change_a_year_ago: mostrar diferencia porcentual respecto al mismo período del año anterior.
• value: mostrar valores originales sin variación (opción por defecto).

Ejemplos

• Si el IPC de marzo fue 0.11 y el de abril 0.088, con 'change' se obtiene -0.022 para abril.

• Si el IPC de marzo fue 0.11 y el de abril 0.088, con 'percentage_change' se obtiene -2.2% para abril.

• Si el IPC de marzo 2023 fue 0.077 y el de marzo 2024 fue 0.11, con 'change_a_year_ago' se obtiene 0.033 para abril 2024.

• Si el IPC de marzo 2023 fue 0.077 y el de marzo 2024 fue 0.11, con 'percentage_change_a_year_ago' se obtiene 3.3% para abril 2024.

Tipostring

Enum

valuechangepercent_changechange_a_year_agopercent_change_a_year_ago

Ejemplovalue

defaultvalue

collapse

Modificar el intervalo de tiempo utilizado por la serie. Si no se indica nada, se mantiene la frecuencia original. Opciones disponibles:

• year: transformar datos para mostrarlos con frecuencia anual.
• quarter: transformar datos para mostrarlos con frecuencia trimestral.
• semester: transformar datos para mostrarlos con frecuencia semestral.
• month: transformar datos para mostrarlos con frecuencia mensual.
• week: transformar datos para mostrarlos con frecuencia semanal.
• day: mostrar datos con frecuencia diaria.

Observaciones

• Cada serie tiene una frecuencia original. Si se indica una frecuencia más alta (ejemplo 'week' para una serie mensual), la API arrojará error.

• Al consultar varias series, 'collapse' afecta a todas y debe ser válido para todas.

• Por defecto, los datos obtenidos al aplicar 'collapse' son promedios, salvo indicación contraria en 'collapse_aggregation'.

Tipostring

Enum

yearquartersemestermonthweekday

Ejemplomonth

collapse_aggregation

Obtener promedios, sumatorias, valores máximos y mínimos de una serie de tiempo. Los datos pueden ser anuales, semestrales, trimestrales, mensuales o semanales según lo especificado en 'collapse'. Opciones disponibles:

• avg: promediar valores del intervalo (opción por defecto).
• sum: sumar todos los valores del intervalo.
• end_of_period: obtener el último valor del intervalo.
• min: obtener valor mínimo del intervalo.
• max: obtener valor máximo del intervalo.

Observaciones

• Para que 'collapse_aggregation' funcione es necesario especificar un valor válido en 'collapse'.

• Al consultar varias series sin especificar 'collapse', se usará por defecto el intervalo de la serie con intervalos más largos (ej: si hay una serie mensual y otra semestral, se calcularán valores por semestre).

Tipostring

Enum

avgsumend_of_periodminmax

Ejemploavg

defaultavg

limit

Este parámetro opcional permite especificar la cantidad máxima de valores que se desean obtener. Debe especificarse un número entero positivo, no mayor que 1000, ya que esa es la cantidad máxima de resultados devueltos por la API. El valor por defecto si no se especifica valor alguno es 100.

Tipointeger

Ejemplo100

maximum1000

minimum1

default100

start_date

Fecha y hora en formato ISO 8601. En el parámetro 'start_date' se especifica la fecha a partir de la cual nos interesa obtener datos. Admite AAAA-MM o AAAA-MM-DD.

Tipostring

end_date

Fecha y hora en formato ISO 8601. El parámetro 'end_date' indica la última fecha de la que nos interesa obtener datos.Admite AAAA-MM o AAAA-MM-DD

Tipostring

start

El parámetro opcional 'start' nos permite hacer un filtro extra y excluir valores de la serie.Se debe brindar un entero positivo que corresponderá a la cantidad de valores que se dejarán afuera, contando desde el comienzo de la serie.

Tipointeger

minimum0

default0

format

Especificar el formato de los datos solicitados. Opciones disponibles:

• json: devolver objeto json con datos y metadatos de las series.
• csv: devolver series en formato separado por comas (sin metadatos).

Tipostring

Enum

jsoncsv

Ejemplojson

defaultjson

header

Especificar el formato de los encabezados en archivos CSV. Solo aplicable cuando format=csv. Opciones disponibles:

• titles: usar títulos de las series (ej: 'oferta_global_pib') - opción por defecto.
• ids: usar identificadores únicos de las series (los mismos del parámetro ids).
• descriptions: usar descripciones completas (ej: 'Plazo fijo entre 60-89 días en millones de pesos. Categoría II-VI').

Tipostring

Enum

titlesidsdescriptions

defaulttitles

sort

Especifica el orden temporal de los resultados devueltos, siendo asc el valor por defecto.Las opciones disponibles son:

• asc: Se devuelven los valores más antiguos primero (indicación por defecto).
• desc: Se devuelven los valores más recientes primero.

Tipostring

Enum

ascdesc

Ejemploasc

defaultasc

metadata

Especificar el nivel de detalle de metadatos. Solo aplicable cuando format=json. Opciones disponibles:

• none: devolver solo datos, sin metadatos.
• only: devolver solo metadatos, sin datos.
• simple: devolver metadatos esenciales para comprender y utilizar las series (opción por defecto).
• full: devolver todos los metadatos disponibles relacionados con cada serie.

Tipostring

Enum

noneonlysimplefull

Ejemplosimple

defaultsimple

decimal

Especificar el carácter para números decimales. Solo aplicable cuando format=csv. Opciones disponibles:

• ,: usar coma.
• .: usar punto (opción por defecto).

Tipostring

Enum

.,

default.

sep

Especificar el carácter separador de valores. Solo aplicable cuando format=csv. Se puede usar cualquier carácter UTF-8, aunque se recomienda mantener la coma (,) que es el valor por defecto.

Tipostring

default,

last

Obtener los últimos N valores de la serie. Especificar un número entero que indica cuántos valores finales se desean. No usar junto con 'start', 'sort' o 'limit'.

Tipointeger

maximum1000

minimum0

Respuestas

La consulta se ejecutó exitosamente

Content-Type

application/json

object[]

object

object

object