Dynamo Developer DocsDynamo Developer Docs
External APIPosts

Get a published post

Fetch a single published post. `mediumId` is **required** — published posts are stored per channel.

GET/posts/{postId}

Authorization

x-api-key x-date x-signature
x-api-key<token>

Your API key (the ApiKeys document id).

In: header

x-date<token>

Current timestamp in ISO-8601 (must be fresh — within −5s..+60s of server time).

In: header

x-signature<token>

HMAC-SHA256 of the x-date string keyed by your secret, lowercase hex.

In: header

Path Parameters

postId*string

The published post id.

Query Parameters

mediumId*string

The channel id (from GET /channels).

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/posts/string?mediumId=string"
{  "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 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.

Get published-post insights

Performance for one published post and its superpower: public/private replies, link-button clicks + CTR, reactions, comments, shares, auto-likes. Computed on demand (Amplitude reply funnels + a live Meta call), so it is slower than the plain post lookup. Covers up to the last 365 days; older posts come back with `isOldPost=true` and empty funnel metrics. `mediumId` is **required** (posts are per channel).