Nueva modalidad para realizar búsqueda con el recurso /search

21 diciembre 2017

Todas las búsquedas respecto a Items de la forma users/{Cust_id}/items/search, Preguntas y Respuestas de la forma /questions/search deberán hacerse con access token. En caso de no utilizarlo, fallará.

Nuevos recursos (Scan + Hash)

Todas las búsquedas que se realicen a la API de Items, Preguntas y Respuestas de la forma users/{Cust_id}/items/search o /questions/search mayor a 1.000 deberán tener el nuevo parámetro search_type=scan sin utilizar el parámetro offset.
Nota: en caso que desees consultar datos menores a 1.000 podrás seguir haciéndolo como hasta ahora (con offset).

Los pasos para consultar más de 1.000 resultados son los siguientes:

  • Agregar search_type=scan a la consulta y quitar el offset.
  • En el resultado obtendrás un campo scroll_id.
  • Deberás agregar a la consulta scroll_id igual al campo obtenido anteriormente.
  • Obtendrás los resultados a partir de los 1.000.
  • En caso de no utilizar el parámetro limit se devolverá por defecto 50 items del total. Podrás agregar un limit máximo de 100.
  • Para seguir obteniendo las próximas páginas de resultados basta con hacer el mismo GET a la llamada hasta llegar al final de la lista.

A continuación te mostraremos paso a paso como hacerlo:

– Agregar search_type=scan para obtener el scroll_id:

Items

https://api.mercadolibre.com/users/{Cust_id}/items/search?search_type=scan&access_token=$ACCESS_TOKEN

Questions

https://api.mercadolibre.com/questions/search?search_type=scan&item={Item_id}&access_token=$ACCESS_TOKEN

Respuesta

"scroll_id": "YXBpY29yZS1pdGVtcw==:ZHMtYXBpY29yZS1pdGVtcy0wMQ==:DXF1ZXJ5QW5kRmV0Y2gBAAAAABIu7AgWMXl6anF3SU5SMVNaQXFxTkZubHBqQQ=="

– Agregamos el scroll_id= obtenido en el paso anterior:

https://api.mercadolibre.com/users/{Cust_id}/items/search?search_type=scan&access_token=$ACCESS_TOKEN&scroll_id=YXBpY29yZS1pdGVtcw==:ZHMtYXBpY29yZS1pdGVtcy0wMQ==:DXF1ZXJ5QW5kRmV0Y2gBAAAAABIu7AgWMXl6anF3SU5SMVNaQXFxTkZubHBqQQ==

Para seguir obteniendo las próximas páginas de resultados basta con hacer el mismo GET a la llamada hasta llegar al final de la lista.

Sabrás cuando llegue al final cuando devuelva null dicho GET.