Docs

Analytics & AI API

Access retention metrics and run AI-powered churn analysis.

Get Retention Stats

GET /api/v1/public/analytics
Authorization: Bearer rq_live_xxx

# Response
{
  "total_sessions": 40,
  "retention_opportunities": 18,
  "confirmed_retained": 12,
  "retention_rate_percent": 45.0,
  "revenue_saved": 588,
  "active_flows": 2,
  "total_customers": 20
}

Get Top Churn Reasons

GET /api/v1/public/analytics/reasons
Authorization: Bearer rq_live_xxx

# Response
{
  "reasons": [
    { "reason": "Too Expensive", "count": 12 },
    { "reason": "Not Using Enough", "count": 9 },
    { "reason": "Missing Features", "count": 7 }
  ]
}

Run AI Churn Analysis

Analyzes your last 60 sessions and returns AI-generated insights. Requires at least 3 sessions.

POST /api/v1/public/intelligence/analyze
Authorization: Bearer rq_live_xxx

# Response
{
  "analysis": {
    "summary": "Retention rate is 47%. Top drivers are...",
    "top_drivers": [...],
    "recommendations": [...],
    "offer_insights": {...}
  },
  "sessions_analyzed": 40
}

Ask AI

Ask a freeform question about your churn data.

POST /api/v1/public/intelligence/ask
Authorization: Bearer rq_live_xxx
Content-Type: application/json

{ "question": "Which offer works best for price-sensitive users?" }

# Response
{
  "answer": "Based on your data, the discount_fixed offer...",
  "sessions_analyzed": 40
}