List posts on a platform

List posts published to a connected platform account, with stats.

Live-fetches the most recent posts on the connected account (Marky-posted or otherwise) plus each post's metrics. Works across Facebook, Instagram, LinkedIn, Twitter/X, TikTok, Pinterest, and YouTube. Pagination via the returned next_cursor for platforms that support it.

Some accounts cannot be listed at all — a LinkedIn personal profile, or a platform whose reads we have turned off on cost grounds. Those return 200 with posts: [] and a populated unavailable_reason, NOT an error. Read that field before concluding the account has no posts.

unavailable_reason is also set when the posts ARE returned but their stats could not be: an Instagram account holding media from before it became a business account gets its posts with every metric null. Null means UNKNOWN, never zero — do not report it as no engagement.

Errors: 400 invalid_value: The integration_id is not a valid UUID. 400 invalid_request: The date range or pagination cursor was rejected. 401 authentication_required: API key or token is missing, invalid, or revoked. 401 SOCIAL_TOKEN_EXPIRED: The connected account's token expired and could not be refreshed — the response's reconnect_url points to where to reconnect. 403 permission_denied: Your plan does not include API access. 404 resource_not_found: No integration with that ID exists, or it is not in your org. 429 rate_limit_exceeded: You sent too many requests this minute. 502 UPSTREAM_PROVIDER_ERROR: The social platform returned an error while fetching posts.