View source for Personal APIs

= Personal APIs =

''Data aggregation system for self-quantification and AI context enhancement''

== Architecture Overview ==

Built on [https://nuxt.com/ Nuxt] / [https://nitro.unjs.io/ Nitro] with basic caching layer. All endpoints return JSON and support CORS for cross-origin requests from mobile apps and AI assistants.

Base URL: `https://ejfox.com/api/`

=== Core Philosophy ===
* '''AI Context Enhancement''' - Provide rich personal data to language models
* '''Self-Quantification''' - Track KPIs aligned with personal improvement goals  
* '''Data Sovereignty''' - Own your data instead of just feeding the surveillance machine
* '''API-First Design''' - Choose services that offer data egress and avoid data silos

== Active Endpoints ==

=== Health & Fitness ===
* '''[https://ejfox.com/api/health /api/health]''' - Apple Health aggregated metrics
* '''[https://ejfox.com/api/health-raw /api/health-raw]''' - Raw health data for deeper analysis

Tracks: daily steps, exercise minutes, stand hours, distance, heart rate variability

=== Productivity & Learning ===
* '''[https://ejfox.com/api/rescuetime /api/rescuetime]''' - [https://www.rescuetime.com/ RescueTime] productivity analytics
* '''[https://ejfox.com/api/leetcode /api/leetcode]''' - [https://leetcode.com/ LeetCode] problem-solving progress
* '''[https://ejfox.com/api/monkeytype /api/monkeytype]''' - [https://monkeytype.com/ MonkeyType] typing speed metrics
* '''[https://ejfox.com/api/chess /api/chess]''' - [https://www.chess.com/ Chess.com] rating and puzzle stats

=== Development ===
* '''[https://ejfox.com/api/github /api/github]''' - [https://github.com/ejfox GitHub] contribution patterns and repo activity
* '''[https://ejfox.com/api/stats /api/stats]''' - Aggregated development metrics

=== Creative & Content ===
* '''[https://ejfox.com/api/photos /api/photos]''' - Personal photo platform statistics
* '''[https://ejfox.com/api/lastfm /api/lastfm]''' - [https://www.last.fm/user/ejfox Last.fm] music listening history (10+ years)
* '''[https://ejfox.com/api/words-this-month /api/words-this-month]''' - Writing output tracking

=== Predictions & Analysis ===
* '''[https://ejfox.com/api/predictions /api/predictions]''' - Personal forecasting and goal tracking

== Technical Implementation ==

=== Data Sources ===
* '''Apple Health''' - via HealthKit exports and processing
* '''GitHub API''' - commit patterns, repo activity, contribution graphs
* '''RescueTime API''' - time tracking and productivity metrics
* '''Chess.com API''' - game history and ratings
* '''Last.fm API''' - scrobbling data going back 10+ years
* '''LeetCode scraping''' - problem completion and difficulty tracking
* '''MonkeyType''' - typing test results and WPM progression

=== Caching Strategy ===
Most endpoints implement intelligent caching:
* '''Health data''' - Updates every 4 hours
* '''GitHub activity''' - Updates every hour
* '''Music listening''' - Updates every 30 minutes
* '''Static metrics''' - Cached for 24 hours

=== Response Format ===
All endpoints return JSON with consistent structure:
```json
{
  "data": { /* endpoint-specific data */ },
  "meta": {
    "cached_at": "2025-05-28T10:30:00Z",
    "source": "api_name",
    "updated": "recent" | "stale"
  }
}