GET /api/analytics/tracking
Get 30-day usage analytics and tracking insights
Retrieve comprehensive 30-day usage analytics including completion rates, cross-platform adoption, and productivity patterns.
Endpoint URL
GET https://game.regardingwork.com/api/analytics/tracking
Authentication
JWT Bearer token required📤 Request
Headers
Authorization: Bearer <your_jwt_token>
Optional Query Parameters
days
- Number of days to analyze (default: 30, max: 90)source
- Filter by source (mac_app, web_timer, etc.)include_team
- Include team analytics (true/false)
✅ Response (200 OK)
{
"period": {
"days": 30,
"start_date": "2025-07-25",
"end_date": "2025-08-24"
},
"session_analytics": {
"total_sessions": 89,
"completed_sessions": 82,
"cancelled_sessions": 7,
"completion_rate": 92.1,
"total_minutes": 3420,
"average_session_length": 38.4
},
"platform_usage": {
"mac_app": {"sessions": 45, "percentage": 50.6},
"web_timer": {"sessions": 32, "percentage": 36.0},
"windows_app": {"sessions": 12, "percentage": 13.5}
},
"productivity_patterns": {
"most_productive_hour": 14,
"most_productive_day": "Tuesday",
"peak_focus_duration": 45,
"average_pof_score": 87.3
},
"category_breakdown": {
"Programming": {"sessions": 34, "minutes": 1530},
"Writing": {"sessions": 18, "minutes": 720},
"Design": {"sessions": 12, "minutes": 480},
"Meeting": {"sessions": 25, "minutes": 690}
},
"weekly_trends": [
{"week": "Week 1", "sessions": 18, "avg_pof": 85.2},
{"week": "Week 2", "sessions": 22, "avg_pof": 88.1},
{"week": "Week 3", "sessions": 25, "avg_pof": 89.7},
{"week": "Week 4", "sessions": 24, "avg_pof": 86.4}
]
}
📊 Using Analytics Data
App Optimization
- Show completion rate trends
- Identify optimal session lengths
- Highlight productive time patterns
- Display category preferences
User Insights
- Platform usage distribution
- Weekly productivity trends
- POF score improvements
- Session cancellation analysis
💻 Code Examples
JavaScript (Fetch) - Get 30-day Analytics
const token = localStorage.getItem('jwt_token');
const response = await fetch('https://game.regardingwork.com/api/analytics/tracking?days=30', {
headers: {
'Authorization': `Bearer ${token}`
}
});
const analytics = await response.json();
console.log(`Completion rate: ${analytics.session_analytics.completion_rate}%`);
console.log(`Most productive: ${analytics.productivity_patterns.most_productive_day}s at ${analytics.productivity_patterns.most_productive_hour}:00`);
JavaScript - Platform Usage Chart
// Extract platform data for charts
const platformData = Object.entries(analytics.platform_usage).map(([platform, data]) => ({
name: platform.replace('_', ' ').toUpperCase(),
sessions: data.sessions,
percentage: data.percentage
}));
// Use with Chart.js, D3.js, or other visualization libraries
console.log('Platform usage data ready for charts:', platformData);
🔗 Related Endpoints
User Data
- GET /api/user/data - Current user stats
- GET /api/leaderboard - Compare with others
- GET /api/projects - Project analytics
Session Management
- POST /api/session/start - Track new sessions
- POST /api/pomodoro/submit - Complete sessions
- POST /api/session/cancel - Cancel tracking