Productsup
Platform API

Cursor pagination

How to paginate Platform API responses using cursor-based pagination parameters.

1 min read

The Platform API uses cursor-based pagination for large result sets, available on GET requests only.

HTTP request

GET https://platform-api.productsup.io/platform/v2/....?limit=number1&previous=number2&cursor=number3

The response includes a meta object containing pagination details:

{
  "success": true,
  "Entities": [
    {
    }
  ],
  "meta": {
    "cursor": {
      "current": 0,
      "prev": 0,
      "next": 1,
      "count": 1
    }
  }
}

Cursor parameters

ParameterTypeDefaultDescription
limitinteger50Maximum number of entities per page
cursorinteger0Cursor identifier to return entities with IDs after this value
previousinteger0Return the previous entity ID, or 0 if none exists

Response fields

FieldTypeDescription
metaarraySee cursor fields

Cursor fields

FieldTypeDescription
currentintegerThe current ID of the cursor
previntegerThe previous entity ID
nextintegerThe ID of the next entity page starter
countintegerNumber of entities returned in the current response

On this page

Still stuck?

Reach out to our support team and we’ll help you get unstuck.

Contact support