List posts
Returns a paginated list of posts. Published posts include platformPostUrl with the public URL on each platform. A query parameter that is not listed here returns 400 naming it and the accepted parameters, so a misspelled filter never silently returns the unfiltered list.
Query parameters
Page number (1-based)
Page size. Values above the maximum return 400 rather than being clamped.
Row offset. Takes precedence over page when both are sent; the response pagination.page is derived from it.
Which collection to read. zernio (default) returns posts authored through Zernio. external returns posts synced from the platform (existing/historical posts that were published outside Zernio). Combine with accountId and paginate via page/limit to walk the full synced history (we keep up to the last ~12 months per account).
Filter posts to a specific profile (24-char hex ObjectId). Omit it, or send all or an empty value, to list posts across every profile.
Filter posts to those created by a specific team user (24-char hex ObjectId).
Zero-padded YYYY-MM-DD, or a full ISO 8601 datetime. An empty value means no date filter; any other malformed value returns 400. The same name the other date-window filters use (ads, analytics).
Zero-padded YYYY-MM-DD, or a full ISO 8601 datetime. An empty value means no date filter; any other malformed value returns 400. The same name the other date-window filters use (ads, analytics).
Alias of fromDate, kept for existing callers
Alias of toDate, kept for existing callers
Search posts by text content.
Sort order for results.
Filter posts to those published via a specific account (24-char hex ObjectId).
Response
Paginated posts
Example response
{
"posts": [
{
"platforms": [
{
"platform": "twitter",
"status": "pending",
"platformPostId": "1234567890123456789",
"platformPostUrl": "https://twitter.com/acmecorp/status/1234567890123456789"
}
]
}
]
}