Pagination - OnePerfectSlice

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.

# 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"

import requests

headers = {"Authorization": "Bearer sk_your_api_key"}
base = "https://app.oneperfectslice.ai/api/public/v1/slice-runs"

all_runs = []
offset = 0
limit = 20

while True:
    resp = requests.get(base, headers=headers, params={"limit": limit, "offset": offset})
    page = resp.json()
    all_runs.extend(page["data"])

    if not page["meta"]["pagination"]["hasMore"]:
        break
    offset += limit

print(f"Fetched {len(all_runs)} runs")

const headers = { Authorization: "Bearer sk_your_api_key" };
const base = "https://app.oneperfectslice.ai/api/public/v1/slice-runs";

const allRuns: any[] = [];
let offset = 0;
const limit = 20;

while (true) {
  const resp = await fetch(`${base}?limit=${limit}&offset=${offset}`, { headers });
  const page = await resp.json();
  allRuns.push(...page.data);

  if (!page.meta.pagination.hasMore) break;
  offset += limit;
}

console.log(`Fetched ${allRuns.length} runs`);