🚀 API Documentation
Welcome to the mediagato.party API! Access live data from our radio stream, track database, and scrobble history. All endpoints are public and return JSON.
📡 Live Now Playing Widget
📊 Recent Scrobbles
📖 Available Endpoints
GET
https://api.mediagato.party/health
Check API service status and uptime.
curl https://api.mediagato.party/health
GET
https://api.mediagato.party/radio/now-playing
Get currently playing track with parsed metadata (track, artist, venue, date, album).
curl https://api.mediagato.party/radio/now-playing
GET
https://api.mediagato.party/scrobbles?limit=50
Get play history with track details and timestamps. Default limit: 50.
curl https://api.mediagato.party/scrobbles?limit=10
GET
https://api.mediagato.party/tracks?limit=50
Get deduplicated track catalog with metadata. Default limit: 50.
curl https://api.mediagato.party/tracks?limit=20
⚠️ Usage Notes
- All endpoints return JSON
- No authentication required for read-only endpoints
- CORS enabled for browser requests
- Data updates every 30 seconds via auto-scrobbler
- Please be respectful with request frequency