Social API reference

Social API · Insights

get/v1/communities/{community_id}/posts/{post_id}/insightsAuth

Aggregate insights for a post: total views, unique reach, engagement counts, and a daily views/reach series over ?from/?to (default trailing 30 days).

Path parameters

community_id*string

Social community UUID.

post_id*string · uuid

Id of the post.

Query parameters

fromstring · date

Window start (YYYY-MM-DD).

tostring · date

Window end (YYYY-MM-DD).

Response · 200 Post insights.

post_id*string · uuid

Id of the post.

Example: "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb"

community_id*string · uuid

Id of the community the post belongs to.

Example: "cccccccc-cccc-cccc-cccc-cccccccccccc"

views*number

All-time total impressions.

Example: 4820

unique_reach*number

All-time distinct viewers.

Example: 3110

reaction_count*number

All-time reactions on the post.

Example: 128

comment_count*number

All-time published comments on the post.

Example: 34

repost_count*number

All-time reposts of the post.

Example: 9

quote_count*number

All-time quote posts of the post.

Example: 4

daily*array

Per-day counts in the requested window, oldest first.

Example

Request

GET https://social.productcraft.co/v1/communities/{community_id}/posts/{post_id}/insights
Authorization: Bearer YOUR_TOKEN

Response

{
  "post_id": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb",
  "community_id": "cccccccc-cccc-cccc-cccc-cccccccccccc",
  "views": 4820,
  "unique_reach": 3110,
  "reaction_count": 128,
  "comment_count": 34,
  "repost_count": 9,
  "quote_count": 4,
  "daily": [
    {
      "day": "2026-05-01",
      "views": 340,
      "reach": 210
    }
  ]
}