A hybrid music intelligence API combining Spotify listening data with a public Kaggle
discovery catalog. Computes a listening fingerprint, detects recent taste drift, and
generates explainable AI-powered recommendations.
POST
/api/v1/auth/login
Get token pair
POST
/api/v1/imports/catalog
Import Kaggle catalog
GET
/api/v1/analytics/fingerprint
Listening fingerprint
GET
/api/v1/analytics/changes/recent
Taste drift detection
POST
/api/v1/ai/recommendations/explain
AI recommendations
POST
/api/v1/ai/insights
Generate insight
POST
/api/v1/ai/insights/{id}/critique
Self-critique insight
GET
/api/v1/catalog/{id}/similar
Cosine similarity
POST
/api/v1/catalog/recommend-by-mood
NLP mood recommendations
POST
/api/v1/mcp/invoke
MCP tool invocation
GET
/api/v1/listening-events/stream
SSE live stream
POST
/api/v1/feedback
Track feedback CRUD