Pagination

The OnePerfectSlice API uses offset-based pagination. Pass limit and offset as query parameters to control which page of results you receive.

Request parameters

Parameter	Type	Default	Range	What it does
limit	integer	20	1–100	How many results to return per page
offset	integer	0	0+	How many results to skip before starting the page

Response metadata

Every paginated response includes a meta.pagination object that tells you where you are in the result set:

{
  "data": [ ... ],
  "meta": {
    "pagination": {
      "totalCount": 142,
      "hasMore": true,
      "limit": 20,
      "offset": 0
    }
  }
}

Field	Type	What it tells you
totalCount	integer	Total results across all pages
hasMore	boolean	Whether there are more pages after this one
limit	integer	Page size (echoed from your request)
offset	integer	Current position in the result set

Which endpoints are paginated?

Endpoint	What it returns
GET /slice-runs	Run history for your team
POST /posts/search	Summaries and scorecards matching your filters

All other endpoints return the full result set in a single response.

Fetching all pages

Use the hasMore field to loop through pages. Increment offset by limit each time until hasMore is false.

cURL

# First page
curl "https://app.oneperfectslice.ai/api/public/v1/slice-runs?limit=20&offset=0" \
  -H "Authorization: Bearer sk_your_api_key"

# Second page
curl "https://app.oneperfectslice.ai/api/public/v1/slice-runs?limit=20&offset=20" \
  -H "Authorization: Bearer sk_your_api_key"