Pagination

List endpoints return up to 100 items per request. Page through posts with limit and offset.

Last checked against the API October 10, 2026 · View as Markdown

Endpoint	Parameters	Default	Maximum
`GET /api/v1/posts`	`limit`, `offset`	50	100
`GET /api/v1/analytics`	`limit`	50	100

Posts are returned newest first. Ask for the next page by adding limit to offset, and stop when a page returns fewer items than limit.

Read every scheduled post (Node.js)

const headers = { Authorization: `Bearer ${process.env.POSTPRISM_API_KEY}` };
const limit = 100;
const posts = [];

for (let offset = 0; ; offset += limit) {
  const res = await fetch(
    `https://studio.postprism.app/api/v1/posts?status=scheduled&limit=${limit}&offset=${offset}`,
    { headers }
  );
  const { data, error } = await res.json();
  if (error) throw new Error(error);
  posts.push(...data);
  if (data.length < limit) break;
}

Analytics has no offset: filter by post_id or platform to narrow the results instead.

PreviousRate limits NextList posts