Skip to main content
Analytics endpoints are scoped to a hub and require a team-owner Bearer token. All responses are application/vnd.api+json.

Hub Analytics dashboard

The Admin Analytics page shows four live metric cards: The Last 30 days label is informational; this page does not currently provide a date-range control. The email card uses its own 24-hour default.

New members per week

Below the cards, the New members per week chart shows eight adjacent seven-day ranges ending when the chart loads. The page requests /overview once for each range. Each value counts memberships created within that range that are still active when the request is read. It is not a historical count of everyone who joined: memberships that later became inactive are excluded. A successful zero is shown as zero. Each card loads independently, so one failed request does not hide results from the other cards. When a card request fails without saved data, the page shows an error and a retry action. If saved data is available after a refresh failure, it remains visible with a stale-data notice. A 403 means the viewer is not the team owner: the card hides its metric, including any previously cached value, and shows the owner-only message. Weekly ranges also fail independently. A week with no data because its request failed is marked unavailable (N/A), not zero; other weeks remain visible and unavailable weeks can be retried. Weeks with saved values remain visible with a stale-results notice if refresh fails. For a 403, the chart hides that week’s cached value and the screen-reader list identifies it as access restricted. On phones, the weekly chart scrolls horizontally. It is keyboard-focusable, and a screen-reader list exposes each week’s value or its loading, unavailable, or restricted state.

Base path

All endpoints accept optional from / to ISO-8601 query parameters (from must be strictly before to). When omitted, a default window is applied (30 days for most endpoints, 24 hours for /email).

GET /overview

Returns the three core membership KPIs for the hub. Resource type: analytics_overview

GET /engagement

Returns membership KPIs plus six community/content leaderboards. Resource type: analytics_engagement Default: all sections returned at top-10.

Single-section pagination

Add section=<name> and page[size]=<1..100> to fetch one section only:
Valid section values: top_members_by_posts, top_members_by_comments, top_posts, top_content, top_spaces, recent_members. Soft-deleted discussions and comments are excluded from all leaderboards.

GET /email

Returns email deliverability KPIs. Default window: last 24 hours. Resource type: analytics_email_deliverability

GET /top-achievements

Returns achievements ranked by distinct, non-revoked earners in the range. Default window: last 30 days. The dashboard shows the first result in its Top achievement card. Secret achievements are counted but their titles are not returned. If achievements are disabled globally or for this hub, /top-achievements returns 404; when no saved result is available, the dashboard shows “Couldn’t load top achievement” with Try again, which cannot enable the feature.