Insights

AI-powered review intelligence including trust scores, risk analysis, topic trends, and emotion distribution.

Get Insights

GET/api/v1/public/insights

Returns AI-generated intelligence insights for your project. Insights are calculated from analyzed reviews over a 30-day rolling window and refreshed automatically every 24 hours.

Minimum Data: Insights require at least 5 analyzed reviews. If insufficient data is available, the response will return insights: null with a helpful message.

Headers:

x-api-key: YOUR_API_KEY

Response:

Response
{
  "insights": {
    "trustScore": 78,
    "trustTrend": 0.12,
    "trustStability": 0.85,
    "riskScore": 22,
    "riskTopics": [
      {
        "topic": "login",
        "severity": 0.7,
        "count": 5,
        "trend": 0.1
      }
    ],
    "topTopics": [
      {
        "topic": "ui",
        "count": 15,
        "sentiment": 0.8,
        "trend": 0.05
      }
    ],
    "topicTrends": [
      {
        "topic": "performance",
        "weeklyChange": -0.1,
        "monthlyChange": 0.2
      }
    ],
    "emotionDistribution": {
      "joy": 0.35,
      "trust": 0.25,
      "fear": 0.02,
      "surprise": 0.08,
      "sadness": 0.05,
      "disgust": 0.02,
      "anger": 0.03,
      "neutral": 0.20
    },
    "authenticityAverage": 0.92,
    "lastCalculatedAt": "2025-01-15T10:30:00.000Z",
    "reviewCountAnalyzed": 42,
    "window": {
      "days": 30,
      "from": "2024-12-16T00:00:00.000Z",
      "to": "2025-01-15T00:00:00.000Z"
    },
    "analysisVersion": 1
  }
}

Response Fields

Trust Metrics

  • trustScore - Overall trust score (0-100), or null if insufficient data
  • trustTrend - Trust trend (-1 to +1, positive = improving)
  • trustStability - How stable the trust score is (0-1)

Risk Metrics

  • riskScore - Overall risk level (0-100), or null if insufficient data
  • riskTopics - Topics contributing to risk, with severity (0-1) and trend

Topic Intelligence

  • topTopics - Most discussed topics with count, sentiment (-1 to +1), and trend
  • topicTrends - Weekly and monthly topic trend changes

Emotion Distribution

  • emotionDistribution - Percentage distribution of detected emotions (joy, trust, fear, surprise, sadness, disgust, anger, neutral). Values sum to 1.0.

Quality & Metadata

  • authenticityAverage - Average confidence that reviews are genuine (0-1)
  • reviewCountAnalyzed - Number of reviews included in the analysis
  • window - Time period analyzed (days, from, to)
  • lastCalculatedAt - When insights were last calculated
  • analysisVersion - Version of the analysis algorithm

Not Yet Available

If insights have not been calculated yet (e.g. new project or too few reviews), the API returns:

{
  "insights": null,
  "message": "Insights not yet available. They will be calculated after the first sync with sufficient reviews."
}