GET /api/dashboard/analytics

​

Overview

• Goal completion tracking
• Skill development over time
• Networking statistics
• Event engagement metrics
• Recommendation performance

​

Authentication

Authorization: Bearer <supabase_access_token>

​

Rate Limiting

• Limit: 20 requests per minute per user
• Window: Sliding window (1 minute)
• Response: HTTP 429 if rate limit exceeded

​

Request

​

HTTP Method

GET /api/dashboard/analytics

​

Query Parameters

​

Response

​

Success Response (200)

​

Error Responses

{
  "success": false,
  "error": "Authentication required"
}

​

Examples

​

Basic Analytics Request

curl -X GET "https://kurecal.app/api/dashboard/analytics" \
  -H "Authorization: Bearer <token>"

​

Analytics with Recommendations

curl -X GET "https://kurecal.app/api/dashboard/analytics?includeRecommendations=true&eventLimit=20" \
  -H "Authorization: Bearer <token>"

​

Display Goal Progress

const { data } = await fetch('/api/dashboard/analytics', {
  headers: { 'Authorization': `Bearer ${token}` }
}).then(r => r.json());

const { goalProgress } = data.analytics;

console.log(`Total Goals: ${goalProgress.totalGoals}`);
console.log(`Completed: ${goalProgress.completedGoals}`);
console.log(`In Progress: ${goalProgress.inProgressGoals}`);

goalProgress.goalBreakdown.forEach(goal => {
  console.log(`${goal.goal}: ${goal.progress}% (${goal.eventsAttended} events)`);
});

​

Analytics Computation

​

Goal Progress Calculation

• Events attended that align with goal
• Skills gained related to goal
• Time elapsed since goal set
• Completion criteria (goal-specific)

​

Skill Development Tracking

• Events attended for each skill
• Practice time logged (if available)
• Proficiency level changes
• Peer comparison (optional)

​

Networking Metrics

• Direct connections made at events
• Follow relationships established
• Circle memberships joined
• Event attendance overlap with network

​

Cache Strategy

​

Cache Headers

Cache-Control: private, max-age=120, stale-while-revalidate=300
X-Data-Freshness: 120s
X-Cache-Strategy: analytics-optimized
X-Processing-Time: 347

​

Cache Invalidation

• User tracks/untracks an event
• Career profile is updated
• Goal completion status changes
• Event attendance is marked

​

Performance Considerations

​

Processing Time

• Typical: 200-500ms
• With recommendations: 400-800ms
• Cold start: 800-1200ms (first request after cache expiry)

​

Optimization Strategies

• Analytics computed using database aggregation functions
• Tracked events fetched in lightweight mode (minimal fields)
• Parallel computation of independent metrics
• Incremental updates for frequently accessed data

​

Rate Limiting

• Cache analytics data on client for 2+ minutes
• Use includeRecommendations=false when only analytics needed
• Fetch analytics once per dashboard visit, not per component mount

​

Related Endpoints

• GET /api/profile/career - Career profile used for analytics
• POST /api/events/tracked - Track events to update analytics
• GET /api/events/recommendations - Get recommendations separately