Dynamo Developer DocsDynamo Developer Docs
External APICommunityPosts

List published posts

List a channel's published posts, newest first — each with engagement metrics and its attached superpower (or `null`). Engagement counts in `metrics` are fetched **live from Meta** at read time (stored counts are the fallback). Only posts the channel authored itself are returned (no ads, dark, or visitor posts). Omit `mediumId` to aggregate across all channels.

get/posts

Beta

The External API is in beta. Endpoints, parameters, and response shapes may change — including breaking changes — in future releases. Pin to documented behavior before relying on it in production.

Authorization

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

Your API key (the ApiKeys document id).

In: header

x-date<token>

Current timestamp as an IMF-fixdate string (GMT, US locale) "EEE, dd MMM yyyy HH:mm:ss z", e.g. "Sun, 06 Dec 2020 12:59:11 GMT". 30-second TTL.

In: header

x-signature<token>

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

In: header

x-api-version<token>

API version you're coding against — currently 1. Required; a missing or unsupported value returns 400 with Missing or unsupported x-api-version header. Supported versions: 1.

In: header

Query Parameters

mediumId?string

Scope to one channel. Omit to aggregate across all channels.

type?string

Filter by publication type.

startDate?string

ISO-8601 — only posts published at or after this instant.

endDate?string

ISO-8601 — only posts published at or before this instant.

limit?integer

Max posts to return.

Response Body

application/json

application/json

application/json

application/json

application/json

Try it

read-only

Kept in this tab only and signed in your browser — your secret never leaves your device.

Query

Enter your key and secret to send.

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": 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": "string",      "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 workspaces

List the org's workspaces to discover `workspaceId`s — the entrypoint for the workspace-scoped VIP routes, which exist only in VIP workspaces.

Get a published post

Fetch a single published post. `mediumId` is **required** — published posts are stored per channel. Engagement counts in `metrics` are fetched **live from Meta** at read time (stored counts are the fallback).