Sign in
Posts

List posts with pagination and filters

Retrieve a paginated list of all your scheduled, draft, published, and failed posts.

Pagination behavior: The page and limit parameters are silently clamped to valid ranges rather than returning errors. page is clamped to a minimum of 1, and limit is clamped to 1-100.

Platform filtering: The platform filter uses case-insensitive prefix matching.

get/list-posts

Query parameters

pageinteger

Page number (1-indexed). Values < 1 are silently clamped to 1.

limitinteger

Items per page. Values are silently clamped to range 1-100.

status'draft' | 'scheduled' | 'published' | 'failed' | 'partially_published'

Filter by post status

platform'twitter' | 'linkedin' | 'instagram' | 'threads' | 'tiktok' | 'youtube' | 'facebook' | 'bluesky' | 'mastodon' | 'telegram' | 'pinterest'

Filter by platform (case-insensitive prefix matching)

sortBy'createdAt' | 'updatedAt' | 'scheduledTime'

Field to sort by

sortOrder'asc' | 'desc'

Sort order

fromDatestring date-time

Filter posts scheduled after this ISO 8601 date

toDatestring date-time

Filter posts scheduled before this ISO 8601 date

Headers

x-publora-user-idstring

Managed user ID (workspace only)

Response

Paginated list of posts

successboolean

Example response

{
  "success": true,
  "posts": [
    {
      "postGroupId": "507f1f77bcf86cd799439011",
      "content": "Excited to share our new product launch!"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "totalItems": 47,
    "totalPages": 3,
    "hasNextPage": true
  }
}

Changes