Aggregations

Get aggregated statistics, rating distributions, sentiment analysis, and per-source breakdowns.

Get Aggregations

GET/api/v1/public/aggregations

Legacy: /api/aggregations is still supported (redirects to /api/v1/public/aggregations)

Retrieves aggregated statistics including per-source breakdowns (Public API, API key required).

Headers:

x-api-key: YOUR_API_KEY

Response:

Response

{
  "totalReviews": 42,
  "averageRating": 4.3,
  "ratingDistribution": {
    "1": 2,
    "2": 3,
    "3": 5,
    "4": 12,
    "5": 20
  },
  "sentimentDistribution": {
    "positive": 28,
    "neutral": 10,
    "negative": 4
  },
  "sources": [
    {
      "id": "src_...",
      "total": 20,
      "averageRating": 4.5,
      "type": "APP_STORE",
      "name": "App Store - MyApp"
    },
    {
      "id": "src_...",
      "total": 22,
      "averageRating": 4.1,
      "type": "GOOGLE_PLAY",
      "name": "Google Play - MyApp"
    }
  ],
  "aiSummary": null
}

AI Summary (Growth & Scale plans)

On paid plans, the aiSummary field returns an AI-generated summary of your recent reviews. On the Starter plan, this field is always null.

{
  "aiSummary": {
    "summary": "Customers praise the intuitive UI and fast performance...",
    "generatedAt": "2025-01-15T10:30:00.000Z",
    "reviewCount": 42
  }
}