Social API reference

Social API · Stats

get/v1/workspaces/{workspace_id}/statsAuth

Social stats for a workspace

Community count, published posts, active members, posts, comments and reactions in the window, the most recent activity and a daily active-members series, across every community in the workspace. **Active** means the member published a post, published a comment or reacted. Days are UTC. Counts only: no member ids, handles or author lists. Cached for up to 60 seconds (`generated_at`).

Path parameters

workspace_id*string · uuid

Workspace id.

Query parameters

windowenum (3)

Window for `in_window` and the length of `series`, in UTC days ending today.

Response · 200 Social stats.

window*object

Window the counts cover.

Example: "30d"

generated_at*string · date-time

When these numbers were computed. Responses are cached for up to 60 seconds.

Example: "2026-10-07T09:00:00.000Z"

last_activity_at*string · date-time

Most recent post, comment or reaction in any of the workspace's communities (activity is kept for 400 days). Null when there has been none.

Example: "2026-10-07T08:41:12.000Z"

totals*object

All-time counts.

in_window*object

Counts for the window.

series*object

Daily active members.

Example

Request

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

Response

{
  "window": "30d",
  "generated_at": "2026-10-07T09:00:00.000Z",
  "last_activity_at": "2026-10-07T08:41:12.000Z",
  "totals": {},
  "in_window": {},
  "series": {}
}