List posts published on the platform

Returns the 25 most recent posts that exist on the platform for a connected account, read live from the platform API. This covers everything on the account, including posts that were never created through Zernio.

Use it to obtain the platform's own post id, which the analytics endpoints take as input. On YouTube the returned id is the video ID that GET /v1/analytics/youtube/daily-views, /video-retention and /demographics expect as videoId, so this endpoint is what backs a video picker in your own UI.

Not every field applies to every platform: reactionCount is Facebook and LinkedIn, shareCount is platform dependent, cid is the Bluesky content id needed to reply, and subreddit is Reddit only. Absent fields are omitted from the response.

The account's token is refreshed before the call when it has expired. When the refresh cannot recover it, the response is a 401 with code TOKEN_EXPIRED and the account has to be reconnected.

{  "status": "success",  "posts": [    {      "id": "dQw4w9WgXcQ",      "platform": "youtube",      "message": "How to schedule a post\n\nA short walkthrough.",      "createdTime": "2026-08-21T09:14:03.000Z",      "permalink": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",      "picture": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg",      "mediaType": "video",      "commentCount": 12,      "likeCount": 340    }  ],  "lastUpdated": "2026-08-28T11:02:44.512Z"}