Social API reference

Social API · Analytics

get/v1/workspaces/{workspace_id}/communities/{community_id}/analyticsAuth

Community-level analytics rollup: total active actors, published posts, published comments, open flags, and last-7-day windows for each.

Path parameters

workspace_id*string

ProductCraft workspace UUID.

community_id*string

Social community UUID owned by the workspace.

Response · 200 Computed analytics rollup.

community_id*string · uuid

Community UUID.

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

total_actors*number

Active actor rows count.

Example: 1234

total_posts*number

Posts where status='published'.

Example: 5678

total_comments*number

Comments where status='published'.

Example: 9876

total_open_flags*number

Flags where status='open'.

Example: 3

posts_last_7d*number

Posts created in the last 7 days (any status).

Example: 42

comments_last_7d*number

Comments created in the last 7 days (any status).

Example: 88

actors_last_7d*number

Actors created in the last 7 days.

Example: 12

computed_at*string · date-time

ISO timestamp this rollup was computed at.

Example: "2026-05-01T12:00:00.000Z"

Example

Request

GET https://social.productcraft.co/v1/workspaces/{workspace_id}/communities/{community_id}/analytics
Authorization: Bearer YOUR_TOKEN

Response

{
  "community_id": "cccccccc-cccc-cccc-cccc-cccccccccccc",
  "total_actors": 1234,
  "total_posts": 5678,
  "total_comments": 9876,
  "total_open_flags": 3,
  "posts_last_7d": 42,
  "comments_last_7d": 88,
  "actors_last_7d": 12,
  "computed_at": "2026-05-01T12:00:00.000Z"
}