This is the SomaScrobbler API. Get auto-corrected and enhanced track metadata for SomaFM radio stations in real-time.
This service a fan project and neither directly or indirectly affiliated with SomaFM or Last.fm. The source code for this service is available on GitHub for anyone who'd like to improve upon it or run their own copy. If you encounter any problems please report an issue.
The service currently provides data for the following stations. Stations turn red if they haven't received a new track within 20 minutes. A red station my indicate a problem, however some stations have extremely long tracks.
Returns the version of the SomaScrobbler API server.
Returns an object containing a list of SomaFM radio stations.
Returns an object containing the number of connections, uptime, and last update times for each station in milliseconds in UTC.
Returns metadata about the currently playing track for a given SomaFM station.
To receive track metadata you need to subscribe to each station using the station ID by emitting a
You will stop receiving updates if you emit an
Track metadata is provided by the
Here's what a track object might look like:
Here's a complete example. Want to see this in action? Scroll down to the demo that's running this very bit of code.