API Reference

Pagination

Cursor-based list endpoints

OpenPost list endpoints return newest-first and accept a limit query parameter. The response always has the shape { data: [...] }.

Response shape

json

{
  "data": [
    { "id": "3a6f...", "...": "..." },
    { "id": "7bd2...", "...": "..." }
  ]
}

Field	Type	Description
data	array	The resources for this request, newest-first by default.

Requesting with a limit

curl

curl "https://api.openpost.so/v1/posts?limit=50" \
  -H "Authorization: Bearer $OP_KEY"

Parameters

Field	Type	Description
limit	int	Page size. Default 20 for /v1/posts. Pass a larger value (for example 200) to page through manually.
status	string	Filter posts by status (scheduled, published, draft, failed).

Cursor pagination is not yet available. For now, filter with a status query and a high limit, or filter by time range client-side on created_at. We’ll add cursor pagination before any breaking change.

PreviousErrors Next Posts

Last updated April 2026 Edit this page