Community

The community stats endpoint exposes aggregate platform metrics that power the public-facing community page. Data is cached and updated every 7 days.

Caching

Community stats are expensive to compute. Results are cached at the application layer with a 7-day TTL. The cachedAt field in the response indicates when the current snapshot was generated.

To force a refresh outside the normal cycle, contact the platform team. There is no public cache invalidation endpoint.

Endpoints

GET /api/community/stats

Retrieve aggregate community statistics (7-day cache)

No authentication required. This endpoint is publicly accessible.

Response

{
  "success": true,
  "data": {
    "totalTesters": 4821,
    "activeTesters": 1203,
    "totalStudiesCompleted": 1876,
    "totalSessionsCompleted": 28450,
    "avgSessionRating": 4.4,
    "topCountries": [
      { "country": "IT", "testerCount": 820 },
      { "country": "US", "testerCount": 712 },
      { "country": "DE", "testerCount": 544 },
      { "country": "GB", "testerCount": 431 },
      { "country": "BR", "testerCount": 308 }
    ],
    "deviceBreakdown": {
      "desktop": 0.61,
      "mobile": 0.31,
      "tablet": 0.08
    },
    "avgCompensationPerSession": {
      "currency": "USD",
      "amount": 14.20
    },
    "cachedAt": "2026-03-10T00:00:00Z",
    "nextRefreshAt": "2026-03-17T00:00:00Z"
  },
  "error": null,
  "metadata": null
}

Fields

Field	Description
totalTesters	All registered testers on the platform
activeTesters	Testers who completed at least one session in the last 90 days
totalStudiesCompleted	Studies that reached their target session count
totalSessionsCompleted	All confirmed sessions across all studies
avgSessionRating	Average business rating across all confirmed sessions (1-5 scale)
topCountries	Top 5 countries by tester count
deviceBreakdown	Proportion of sessions by device type
avgCompensationPerSession	Platform-wide average payout per completed session
cachedAt	Timestamp of the current snapshot
nextRefreshAt	When the cache will next be invalidated