Sign in
Posts

List posts

Returns a paginated list of posts. Published posts include platformPostUrl with the public URL on each platform.

get/v1/posts

Query parameters

pageinteger

Page number (1-based)

limitinteger

Page size. Values above the maximum return 400 rather than being clamped.

source'zernio' | 'external'

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).

status'draft' | 'scheduled' | 'published' | 'failed'
platformstring
Example:twitter
profileIdstring

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.

createdBystring

Filter posts to those created by a specific team user (24-char hex ObjectId).

dateFromstring date

Zero-padded YYYY-MM-DD, or a full ISO 8601 datetime. An empty value means no date filter; any other malformed value returns 400.

dateTostring date

Zero-padded YYYY-MM-DD, or a full ISO 8601 datetime. An empty value means no date filter; any other malformed value returns 400.

includeHiddenboolean
searchstring

Search posts by text content.

sortBy'scheduled-desc' | 'scheduled-asc' | 'created-desc' | 'created-asc' | 'status' | 'platform'

Sort order for results.

accountIdstring

Filter posts to those published via a specific social 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"
        }
      ]
    }
  ]
}

Changes

Changed in 9 of the 26 revisions of this API.359

  • 0cdc3e98bff911See the full diff
    • ▲

      the posts/items/platforms/items/platformSpecificData response's property type/format changed from / to object/ for status 200

      response-property-type-changed

    • ○

      removed TwitterPlatformData ThreadsPlatformData FacebookPlatformData InstagramPlatformData LinkedInPlatformData PinterestPlatformData YouTubePlatformData GoogleBusinessPlatformData TikTokPlatformData TelegramPlatformData SnapchatPlatformData RedditPlatformData BlueskyPlatformData DiscordPlatformData SlackPlatformData from the posts/items/platforms/items/platformSpecificData response property oneOf list for the response status 200

      response-property-one-of-removed

  • b5344d376e5e4See the full diff
    • ○

      added the optional property posts/items/platforms/items/platformSpecificData/oneOf[InstagramPlatformData]/muteAudio to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property posts/items/platforms/items/platformSpecificData/oneOf[PinterestPlatformData]/boardSectionId to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property posts/items/platforms/items/platformSpecificData/oneOf[PinterestPlatformData]/isAiGenerated to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property posts/items/platforms/items/platformSpecificData/oneOf[ThreadsPlatformData]/firstComment to the response with the 200 status

      response-optional-property-added

  • 26bee5940ef61See the full diff
    • ○

      added the optional property posts/items/platforms/items/platformSpecificData/oneOf[TwitterPlatformData]/article to the response with the 200 status

      response-optional-property-added

  • 5d3a131531d92See the full diff
    • ▲

      the response property posts/items/platforms/items/platformPostUrl became nullable for the status 200

      response-property-became-nullable

    • ▲

      the posts/items/platforms/items/platformPostUrl response's property type/format changed from string/uri to string null/ for status 200

      response-property-type-changed

  • d0ab3b4eb0ae2See the full diff
    • ●

      added the new platform_rate_limit enum value to the posts/items/platforms/items/errorCategory response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new quota_exhausted enum value to the posts/items/platforms/items/errorCategory response property for the response status 200

      response-property-enum-value-added

  • a23bb6e634381See the full diff
    • ○

      added the optional property posts/items/platforms/items/platformSpecificData/oneOf[BlueskyPlatformData]/langs to the response with the 200 status

      response-optional-property-added

  • 0942091eaa8c3See the full diff
    • ●

      added the new phone enum value to the posts/items/platforms/items/accountId/oneOf[SocialAccount]/platform response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new rcs enum value to the posts/items/platforms/items/accountId/oneOf[SocialAccount]/platform response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new sms enum value to the posts/items/platforms/items/accountId/oneOf[SocialAccount]/platform response property for the response status 200

      response-property-enum-value-added

  • e0cd920708581See the full diff
    • ○

      added the optional property posts/items/platforms/items/platformSpecificData/oneOf[LinkedInPlatformData]/poll to the response with the 200 status

      response-optional-property-added

  • 1e9a379eafca1See the full diff
    • ○

      added the optional property posts/items/platforms/items/platformSpecificData/oneOf[InstagramPlatformData]/audioConfiguration to the response with the 200 status

      response-optional-property-added