UniPost
Dashboard

List posts

Returns social posts in reverse chronological order with cursor pagination. Use it for feeds, history views, and sync jobs.
https://api.unipost.dev
GET/v1/posts?{status}&{from}&{to}&{limit}&{cursor}
Authorization
In header · Bearer <token>
Query

Authorization

AuthorizationBearer <token>In header
Workspace API key.

Query Params

status?string
Comma-separated status filter. Example: published,partial.
Valuesdraft | scheduled | publishing | published | partial | failed | cancelled
from?string
Inclusive RFC-3339 lower bound on created_at.
to?string
Exclusive RFC-3339 upper bound on created_at.
limit?integer
Page size. Default 25, max 100.
cursor?string
Opaque cursor returned as meta.next_cursor from the previous page.

Response Body

200
dataarray
List of posts in reverse chronological order.
data[].idstring
UniPost post ID.
data[].statusstring
Derived lifecycle status for the post.
Valuesdraft | scheduled | publishing | published | partial | failed | cancelled
data[].created_atstring
Creation timestamp.
data[].scheduled_atstring | null
Scheduled publish time when present.
data[].published_atstring | null
Publish time when available.
data[].target_platformsstring[]
Platforms inferred from stored metadata.
Valuestwitter | linkedin | instagram | facebook | threads | youtube | tiktok | bluesky | pinterest
meta.limitinteger
Applied page size for this cursor page.
meta.has_moreboolean
Whether another page is available.
meta.next_cursorstring
Cursor to fetch the next page. Empty string means no more results.
request_idstring
Request identifier for debugging and support.
next_cursorstring
Legacy top-level alias for meta.next_cursor during the migration window.
401
error.codestring
Usually "UNAUTHORIZED" or "VALIDATION_ERROR".
error.normalized_codestring
Lowercase alias such as "unauthorized" or "validation_error".
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
422
error.codestring
Usually "UNAUTHORIZED" or "VALIDATION_ERROR".
error.normalized_codestring
Lowercase alias such as "unauthorized" or "validation_error".
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
500
error.codestring
Usually "UNAUTHORIZED" or "VALIDATION_ERROR".
error.normalized_codestring
Lowercase alias such as "unauthorized" or "validation_error".
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.