Saltar a contenido

Referencia API: search

Recurso: /search

El recurso /search permite buscar series a partir de un texto, proporcionando además algunos filtros (ej.: por tema o por unidades de las series).

Tabla de parámetros

Nombre Requerido Descripción Default Ejemplos
q No Texto N/A q=ipc
dataset_theme No Uno de los valores listados en /search/dataset_theme N/A dataset_theme="Finanzas Públicas"
units No Uno de los valores listados en /search/field_units N/A units="Millones de pesos"
dataset_publisher_name No Uno de los valores listados en /search/dataset_publisher_name N/A dataset_publisher_name="Subsecretaría de Programación Macroeconómica."
dataset_source No Uno de los valores listados en /search/dataset_source N/A dataset_source="Ministerio de Hacienda"
catalog_id No Uno de los valores listados en /search/catalog_id N/A catalog_id="sspm"
limit No Número entero positivo, no mayor que 1000. 10 limit=50
start/td> No Número entero positivo o 0. 0 start=100
aggregations No N/A N/A N/A
sort_by No Texto, uno de los listados en la sección del parámetro 'relevance' sort_by=hits_90_days
sort No Texto, puede ser 'asc' o 'desc' 'desc' sort=asc

q

Texto de entrada a buscar en la base de series de tiempo. Puede ser abritrariamente largo, pero se recomienda ingresar una o más palabras clave.

dataset_theme, units, dataset_publisher_name, dataset_source, catalog_id

Estos parámetros pueden ser usados como filtros en los resultados de la búsqueda. Al aplicarse, se muestran únicamente aquellos resultados que sean compatibles con la especificación.

Por ejemplo: un pedido con units=Millones de pesos sólo contendrá series de tiempo que estén expresadas en millones de pesos.

Los términos que aceptan estos parámetros son especificados en recursos auxiliares que devuelven la lista entera de valores aceptados en los filtros.

Por ejemplo: un pedido a /search/field_units devuelve una lista de los términos que se le pueden pasar al parámetro units. Cualquier otra opción devolverá una lista vacía de resultados (al no haber coincidencias). Consultar la tabla de parámetros para ver los endpoints auxiliares.

Se pueden armar consultas que filtren por más de un valor, separando los valores deseados por ||. Por ejemplo: units=Pesos||Millones de pesos.

limit

Este parámetro es utilizado junto a start para controlar el paginado de los resultados devueltos por la API. 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 10.

start

Este parámetro es utilizado junto a limit para controlar el paginado de los resultados devueltos por la API. Debe especificarse un número entero positivo o 0. El valor por defecto si no se especifica valor alguno es 0.

El start indica el "número de resultados después del inicio" que se saltea el buscador para el armado de la respuesta.

aggregations

La presencia de este parámetro agrega un objeto nuevo a la respuesta de la API bajo la clave aggregations, que contiene la cantidad de ocurrencias totales de la búsqueda discriminando por los distintos filtros posibles. Si el parámetro no está presente, no se calculan las agregaciones.

Un ejemplo posible de la respuesta:

{
  "aggregations": {
    "dataset_theme": [
      {
        "label": "Finanzas Públicas",
        "series_count": 904
      },
      {
        "label": "Precios",
        "series_count": 522
      },
      {
        "label": "Sector Externo",
        "series_count": 21
      }
    ],
    "units": [
      {
        "label": "Millones de pesos",
        "series_count": 904
      },
      {
        "label": "Índice",
        "series_count": 509
      },
      {
        "label": "Millones de dólares",
        "series_count": 21
      },
      {
        "label": "Variación Porcentual",
        "series_count": 12
      },
      {
        "label": "Variación intermensual",
        "series_count": 1
      }
    ],
    "dataset_publisher_name": [
      {
        "label": "Subsecretaría de Programación Macroeconómica.",
        "series_count": 1447
      }
    ],
    "dataset_source": [
      {
        "label": "Ministerio de Hacienda",
        "series_count": 925
      },
      {
        "label": "Instituto Nacional de Estadística y Censos (INDEC)",
        "series_count": 522
      }
    ],
    "catalog_id": [
      {
        "label": "sspm",
        "series_count": 1447
      }
    ]
  }
}

sort_by

Este parámetro permite ordenar los resultados obtenidos según el valor que cada uno posee para cierto campo, de manera descendente (es decir, de mayor a menor según dicho valor)

Los valores que puede adoptar el mismo son:

  • relevance: Valor por defecto, para que los resultados se ordenen por relevancia en base a los demás filtros y parámetros
  • hits_90_days: Ordena los resultados según cuántos accesos tuvieron las series en los últimos 90 días (el campo hits de la response)
  • frequency: Ordena los resultados según la periodicidad de la serie (de menor a mayor granularidad: anual, semestral, trimestral, mensual, semanal y diaria). Un orden descendente implica de mayor a menor granularidad

sort

Este parámetro permite determinar el sentido del ordenamiento de los resultados, es decir, ascendente (asc, de menor a mayor) o descendente (desc, de mayor a menor).

Debe tenerse en cuenta que, si se ordena por relevancia, el orden tan sólo puede ser descendente; si se eligiese otro criterio de ordenamiento en el parámetro sort_by, cualquier sentido es válido.