Dynamo Developer DocsDynamo Developer Docs
External APICommunityPosts

Get published-post insights

Performance for one published post and its superpower: public/private replies, link-button clicks + CTR, reactions, comments, shares, auto-likes. Covers up to the last 365 days; older posts come back with `isOldPost=true` and empty funnel metrics. `mediumId` is **required**.

get/posts/{postId}/insights

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

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

Try it

read-only

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

Path

Query

Enter your key and secret to send.

curl -X GET "https://example.com/posts/AbC123XyZ/insights?mediumId=FB_PAGE_123456789012345"
{  "isOldPost": false,  "reactions": 128,  "comments": 64,  "uniqueComments": 57,  "totalAutoLikes": 40,  "shares": 12,  "publicReplies": {    "uniques": 50,    "total": 73  },  "privateReplies": {    "uniques": 48,    "total": 61  },  "buttons": {    "totalClicks": 31,    "CTR": 0.18  },  "potentialTrolls": {    "total": 2,    "KEYWORDS": 2  },  "masterSupport": {    "total": 1  }}
{  "message": "string"}
{  "message": "string"}
{  "message": "string"}
{  "error": [    {      "message": "string",      "path": [        "string"      ],      "type": "string",      "context": {}    }  ]}