List published posts
List posts already live on a channel, most recent first, with engagement metrics and the full attached superpower (or `null`). Only genuine published page posts are returned — those the channel itself authored and published, matching what the in-app feed shows; ads, unpublished/dark posts, and visitor posts are excluded. Published posts are stored per channel: pass `mediumId` to scope to one channel, or omit it to aggregate across all channels (merged, newest first). Optional `type`, `startDate`, and `endDate` filters are applied in memory before the limit.
/postsAuthorization
x-api-key x-date x-signature Your API key (the ApiKeys document id).
In: header
Current timestamp in ISO-8601 (must be fresh — within −5s..+60s of server time).
In: header
HMAC-SHA256 of the x-date string keyed by your secret, lowercase hex.
In: header
Query Parameters
Scope to one channel. Omit to aggregate across all channels.
Filter by publication type.
ISO-8601 — only posts published at or after this instant.
ISO-8601 — only posts published at or before this instant.
Max posts to return.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/posts"[ { "id": "string", "mediumId": "string", "mediumType": "FB_PAGE", "type": "POST", "caption": "string", "mediaUrl": "string", "mediaType": "IMAGE", "thumbnailUrl": "string", "permalink": "string", "publishedAt": "string", "metrics": { "likes": 0, "comments": 0, "shares": 0, "reactions": { "property1": 0, "property2": 0 } }, "superpower": { "creativeTemplateId": "string", "creativeTemplateName": "string", "id": "string", "name": "string", "active": true, "hashtag": "string", "lookupHashtag": "string", "thumbnail": "string", "notes": "string", "note": "string", "caption": "string", "expirationDate": 0, "templateType": "GENERAL", "conditionalTemplateType": "MIX_MATCH", "conditionGroups": [ { "groupId": "string", "name": "string", "conditions": [ { "conditionType": "USER_ACTION", "userActionType": "COMMENTED", "values": [ null ], "aiValues": [ null ], "logicalCondition": "ANY_VALUE", "socialUserProperty": "string", "retentionProperty": "string", "dateCondition": "string", "userProperty": {} } ], "publicReplies": [ { "id": "string", "scope": "PUBLIC", "broadcastMessageType": "REGULAR", "text": "string", "media": "string", "mediaUrl": "string", "mediaType": "IMAGE", "attachmentId": "string", "like": true, "subtitle": "string", "isAIGenerated": true, "isAiGeneratedEdited": true, "active": true, "redirects": [ { "id": "string", "text": "string", "description": "string", "url": "http://example.com", "d10xUrl": "string", "payload": "string", "topicId": "string", "action": "string", "followUpReplies": [ {} ] } ], "carouselItems": [ {} ], "couponCode": "string", "couponExpireTime": "string", "offerName": "string", "greetingText": "string" } ], "privateReplies": [ { "id": "string", "scope": "PUBLIC", "broadcastMessageType": "REGULAR", "text": "string", "media": "string", "mediaUrl": "string", "mediaType": "IMAGE", "attachmentId": "string", "like": true, "subtitle": "string", "isAIGenerated": true, "isAiGeneratedEdited": true, "active": true, "redirects": [ { "id": "string", "text": "string", "description": "string", "url": "http://example.com", "d10xUrl": "string", "payload": "string", "topicId": "string", "action": "string", "followUpReplies": [ {} ] } ], "carouselItems": [ {} ], "couponCode": "string", "couponExpireTime": "string", "offerName": "string", "greetingText": "string" } ], "autoLike": true, "autoLikeProbability": 0, "probability": 0, "publicRepliesProbability": 0, "takesPartInRaffle": true, "detectSentiment": true, "usersLimit": 0, "timeLimit": 0, "timeLimitUnit": "HOUR", "delayDMReplyInHours": 0, "delayPublicReplyInHours": 0, "link": "string", "linkName": "string", "note": "string", "publicRepliesPrompt": "string", "privateRepliesPrompt": "string", "useGenerateRepliesApi": true, "useSuggestedKeywords": true } ], "raffle": { "winnersLimit": 1, "startDate": "string", "endDate": "string", "endedComment": {}, "winnersPrivateReply": { "id": "string", "scope": "PUBLIC", "broadcastMessageType": "REGULAR", "text": "string", "media": "string", "mediaUrl": "string", "mediaType": "IMAGE", "attachmentId": "string", "like": true, "subtitle": "string", "isAIGenerated": true, "isAiGeneratedEdited": true, "active": true, "redirects": [ { "id": "string", "text": "string", "description": "string", "url": "http://example.com", "d10xUrl": "string", "payload": "string", "topicId": "string", "action": "string", "followUpReplies": [ {} ] } ], "carouselItems": [ {} ], "couponCode": "string", "couponExpireTime": "string", "offerName": "string", "greetingText": "string" }, "looseresPrivateReply": { "id": "string", "scope": "PUBLIC", "broadcastMessageType": "REGULAR", "text": "string", "media": "string", "mediaUrl": "string", "mediaType": "IMAGE", "attachmentId": "string", "like": true, "subtitle": "string", "isAIGenerated": true, "isAiGeneratedEdited": true, "active": true, "redirects": [ { "id": "string", "text": "string", "description": "string", "url": "http://example.com", "d10xUrl": "string", "payload": "string", "topicId": "string", "action": "string", "followUpReplies": [ {} ] } ], "carouselItems": [ {} ], "couponCode": "string", "couponExpireTime": "string", "offerName": "string", "greetingText": "string" }, "endedPublicReplies": [ { "id": "string", "scope": "PUBLIC", "broadcastMessageType": "REGULAR", "text": "string", "media": "string", "mediaUrl": "string", "mediaType": "IMAGE", "attachmentId": "string", "like": true, "subtitle": "string", "isAIGenerated": true, "isAiGeneratedEdited": true, "active": true, "redirects": [ { "id": "string", "text": "string", "description": "string", "url": "http://example.com", "d10xUrl": "string", "payload": "string", "topicId": "string", "action": "string", "followUpReplies": [ {} ] } ], "carouselItems": [ {} ], "couponCode": "string", "couponExpireTime": "string", "offerName": "string", "greetingText": "string" } ] }, "shareTarget": 0, "shareTargetEnabled": true, "likeTarget": 0, "likeTargetEnabled": true, "commentTarget": 0, "commentTargetEnabled": true, "globalUsersLimit": 0, "globalTimeLimit": 0, "overrideTrollBuster": true, "overrideMasterSupport": true }, "creativeTemplateId": "string", "creativeTemplateName": "string", "superpowerActivityEnded": true }]{ "message": "string"}{ "message": "string"}{ "message": "string"}{ "error": [ { "message": "string", "path": [ "string" ], "type": "string", "context": {} } ]}List connected channels
List the org's connected channels (mediums). Use a returned `id` as the key in a scheduled post's `channels` map. With the optional `workspaceId` filter only the channels connected to that workspace are returned (the discovery step for the workspace-scoped VIP routes). Tokens are never returned.
Get a published post
Fetch a single published post. `mediumId` is **required** — published posts are stored per channel.