Resultados de paginação

Você pode definir o tamanho da página da lista de resultados. Há dois parâmetros: Limit e Offset. Ambos os parâmetros vão definir o tamanho do bloco dos resultados. Este artigo é baseado no exemplo de busca, mas você pode utilizar paginação em cada recurso apresentado nas informações de resposta sobre “paging”, conforme mostrado a seguir:

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

range-slider

Assuntos

Valores padrão

Os valores padrão são offset=0 e limit=50.
curl https://api.mercadolibre.com/sites/MLA/search?q=ipod nano
Na seção de paginação da resposta JSON você pode visualizar a quantidade total de produtos que correspondem à busca e o valor de offset junto com o limit padrão aplicado.

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

Limit

Para reduzir o tamanho da página, você pode alterar o parâmetro limit. Por exemplo, caso esteja interessado em recuperar somente os três primeiros produtos:

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

Essa ação recupera um dado JSON com um conjunto de três produtos, conforme mostrado a seguir:

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

Offset

Ao usar o atributo offset, você pode mover o limit inferior do bloco de resultados. Por exemplo, se estiver interessado em recuperar os 50 produtos que seguem à resposta padrão:

 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": [...],
}

Essa resposta recupera 50 produtos a partir dos primeiros cinquenta.

Definição de uma faixa de resultados

Ambos os parâmetros podem ser combinados. Você pode recuperar produtos do terceiro ao sexto no resultado de busca original:

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

Essa ação recupera um dado JSON com um conjunto de cinco produtos, conforme mostrado a seguir:

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

Qualifique entre 1 e 5