v2
latestOpenAPI 3.1.02026-08-075421692.0 MBList posts
Returns a paginated list of posts. Published posts include platformPostUrl with the public URL on each platform.
Query parameters
Page number (1-based)
Page size. Values above the maximum return 400 rather than being clamped.
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.
Zero-padded YYYY-MM-DD, or a full ISO 8601 datetime. An empty value means no date filter; any other malformed value returns 400.
Search posts by text content.
Sort order for results.
Filter posts to those published via a specific social account (24-char hex ObjectId).
Response
Paginated posts
Example response
{
"posts": [
{
"platforms": [
{
"platform": "twitter",
"platformSpecificData": {
"geoRestriction": {
"countries": [
"US",
"CA",
"GB"
]
}
},
"status": "pending",
"platformPostId": "1234567890123456789",
"platformPostUrl": "https://twitter.com/acmecorp/status/1234567890123456789"
}
]
}
]
}