Paginación de resultados

Introducción

Puedes definir el tamaño de página de la lista de resultados. Existen 2 parámetros: limit y offset. Ambos parámetros definen el bloque de tamaño de los resultados. Este artículo se basa en el ejemplo de búsqueda, pero puedes utilizar paginación en cada recurso que se presente en la información de respuesta sobre “paginación”, según se muestra a continuación:

.....
  "paging": {
	"total": 285,
	"offset": 0,
	"limit": 50,
  }
  .....

range-slider

Contenidos:

  • Valores por defecto
  • Limit
  • Offset
  • Definir un rango de resultados

Valores por defecto

Los valores por defecto son offset=0 y limit=50.

curl https://api.mercadolibre.com/sites/MLA/search?q=ipod nano

En la sección de paginación de la respuesta JSON, puedes ver la cantidad total de artículos que coinciden con la búsqueda y el valor de offset con el limit por defecto aplicado.

.....
  "paging": {
	"total": 285,
	"offset": 0,
	"limit": 50,
  }
  .....

Limit

Para reducir el tamaño de página, puedes cambiar el parámetro de limit. Por ejemplo, si estás interesado en recuperar solo los primeros 3 artículos:

curl https://api.mercadolibre.com/sites/MLA/search?q=ipod nano&limit=3

Esta acción recupera un dato JSON con un conjunto de 3 artículos, como se ilustra a continuación:

{
  "site_id": "MLA",
  "query": "ipod nano",
  "paging": {
	"total": 284,
	"offset": 0,
	"limit": 3,
  },
  "results": [
	{...},
	{...},
	{...},
  ],
  "sort": {...},
  "available_sorts": [...],
  "filters": [...],
  "available_filters": [...],
}

Offset

Al utilizar el atributo offset, puedes mover el limit inferior del bloque de resultados. Por ejemplo, si te interesa recuperar los 50 artículos que siguen la respuesta por defecto:

curl https://api.mercadolibre.com/sites/MLA/search?q=ipod nano&offset=50
{
  "site_id": "MLA",
  "query": "ipod nano",
  "paging": {
	"total": 285,
	"offset": 50,
	"limit": 50,
  },
  "results": [...],
  "sort": {...},
  "available_sorts": [...],
  "filters": [...],
  "available_filters": [...],
}

Esta respuesta recupera 50 artículos a partir de los primeros cincuenta.

Definir un rango de resultados

Es posible combinar ambos parámetros. Puedes recuperar artículos desde el tercero al sexto en el resultado de búsqueda original:

curl https://api.mercadolibre.com/sites/MLA/search?q=ipod nano&offset=3&limit=3

Esta acción recupera un dato JSON con un conjunto de 5 artículos, como se ilustra a continuación:

{
  "site_id": "MLA",
  "query": "ipod nano",
  "paging": {
	"total": 285,
	"offset": 3,
	"limit": 3,
  },
  "results": [
	{...},
	{...},
	{...},
  ],
  "sort": {...},
  "available_sorts": [...],
  "filters": [...],
  "available_filters": [...],
}

Please rate this