Guía
Paginación por cursor
Todos los listados de v2 se paginan por cursor (no por limit + offset). El cursor es un token opaco que apunta a la posición exacta donde quedó la página anterior — estable y eficiente incluso sobre catálogos de cientos de miles de productos.
- →Pida la primera página sin
cursor. Opcionalmente ajustelimit. - →La respuesta trae
next_cursoryhas_more. Sihas_moreestrue, vuelva a llamar con?cursor=<next_cursor>. - →Cuando
has_moreesfalse,next_cursoresnully terminó.
json
{
"data": [ /* ... */ ],
"next_cursor": "eyJsYXN0X2lkIjoiTUNPMTIzNCIsImZpbHRlcnNfaGFzaCI6IjhhZjMifQ",
"has_more": true,
"count": 100,
"total": 12840
}next_cursorstring | nullrequerido
Token opaco para la siguiente página.
null cuando no hay más. No lo construya ni lo modifique: páselo tal cual lo recibió.has_morebooleanrequerido
true si hay más páginas después de esta.countnumberrequerido
Cantidad de elementos en
data en esta página.totalnumberrequerido
Total de elementos que matchean los filtros. Como en la API de Mercado Libre, sólo se devuelve en la primera petición (sin cursor); en las páginas siguientes no se recalcula.
No cambie los filtros a mitad de una paginación. El cursor está ligado al conjunto de filtros de la primera llamada. Si envía un
cursor junto con filtros distintos, la API reinicia desde el principio y responde con pagination_reset: true y un warning. Para cambiar filtros, empiece una paginación nueva sin cursor.En todos los listados de v2: el catálogo (limit hasta 1000, default 100), jobs (hasta 200, default 50), los items de un job (hasta 500, default 100) y productos de prueba (hasta 200, default 50). Un ejemplo de loop completo está en la guía del catálogo de 1000.