Permite buscar y encontrar series de tiempo de manera más flexible sin necesidad de contar con identificadores. También permite aplicar filtros de búsqueda y organizar los resultados obtenidos de acuerdo a varios criterios.

GET

/search

curl --request GET \
  --url 'http://apis.datos.gob.ar/series/api/search?sort_by=relevance&sort=desc&limit=100&start=0&catalog_id=sspm'

Se pueden buscar series a partir de un texto y hacer filtros de búsqueda en base a temáticas, fuentes, publicadores y catálogo.

Parameters

Query Parameters

q

string

En este parámetro opcional se puede ingresar libremente una o más palabras claves para encontrar series relacionadas.

sort_by

string

default: relevance

Allowed values: relevance hits_90_days frequency

Este parámetro opcional nos permite indicar el criterio con el que queremos que se ordenen las series que hemos obtenido como resultado de una búsqueda. Acá los valores posibles:

• relevance: Los resultados se ordenan según qué tan relevantes son para la búsqueda realizada.
• hits_90_days: Los resultados se ordenan según que tan populares son (que tanto han sido consultados los últimos 90 días).
• frequency: Los resultados se ordenan según la frecuencia que usan (anual, mensual, diaria, etc).

sort

string

default: desc

Este parámetro opcional permite determinar si los resultados obtenidos se ordenan de manera ascendente o descendente de acuerdo al criterio elegido en ‘sort_by’. Si no se ha indicado nada en ‘sort_by’, se ordenarán de acuerdo a relevancia. Los valores posibles son:

• asc: de menor a mayor.
• desc: de mayor a menor.

limit

integer

default: 100 >= 1 <= 1000

Este parámetro nos da la posibilidad de indicar el máximo de resultados que se desea obtener. Debe ser un número entero y no puede ser mayor a 1000, que es la cantidad máxima de resultados que puede arrojar la API. Por defecto será 100.

start

integer

0

El parámetro opcional ‘start’ nos permite omitir los primeros resultados.Se debe brindar un entero positivo que corresponderá a la cantidad de valores que se dejarán afuera.

Este parámetro es particularmente útil para “paginar”, esto se refiere a cuando necesitamos más valores de los que la API nos puede proveer en una sola llamada (1000) por lo que debemos hacer varias llamadas. En cada nueva llamada deberemos empezar donde quedó la anterior por lo que brindar una posición de comienzo es sumamente útil.

dataset_theme

string

Este parámetro opcional permite buscar todas las series de una temática específica. Para saber las temáticas que existen actualmente se puede consultar el siguiente endpoint: https://apis.datos.gob.ar/series/api/search/dataset_theme/

units

string

Este parámetro opcional permite buscar todas las series que usen una misma unidad de medida. Se pueden ver las unidades disponibles en el siguiente endpoint: https://apis.datos.gob.ar/series/api/search/field_units/

dataset_source

string

Este parámetro opcional permite buscar todas las series con una misma fuente. Se pueden ver las fuentes existentes actualmente en el siguiente endpoint: https://apis.datos.gob.ar/series/api//search/dataset_source/

dataset_publisher_name

string

Este parámetro opcional permite buscar todas las series de un mismo publicador. Se pueden ver los publicadores existentes actualmente en el siguiente endpoint: https://apis.datos.gob.ar/series/api/search/dataset_publisher_name/

catalog_id

string

Allowed values: sspm snic obras turismo bcra justicia jgm agroindustria smn salud energia defensa cultura otros transporte

Este parámetro opcional permite buscar todas las series de un mismo catálogo. Admite los siguientes valores:

• sspm

• snic

• obras

• turismo

• bcra

• justicia

• jgm

• agroindustria

• smn

• salud

• energia

• defensa

• cultura

• otros

• transporte

aggregations

string

Este parámetro opcional, permite obtener también un conteo de resultados obtenidos así como un detalle de cuantos de estos resultados son de cada eje temáticos, de cada publicador, de cada fuente, de cada catálogo y de cada unidad de medida. Si no deseamos activar este parámetro dejar el campo de abajo vacio.En caso contrario,escribir cualquier caracter.

Responses

200

La consulta se ejecutó exitosamente

Media typeapplication/json

Array<object>

object

data

object

count

number

limit

number

start

number

aggregations

object

Example^generated

[
  {
    "data": {},
    "count": 1,
    "limit": 1,
    "start": 1,
    "aggregations": {}
  }
]

400

Solicitud incorrecta