Skip to content
Hugh Rawlinson edited this page Jun 7, 2015 · 4 revisions

API

Soundwave have released a public API specifically for the MIDEM Music Hack Day!

Auth

Contact Hugh (@raw on the Music Hack Day Slack) for an API key. You must include the API key as a GET parameter on API requests.

Methods

Charts

These methods provide charts based on cross-service song plays.

Top

These are the top charts of "all time".

http://soundwaveapi.herokuapp.com/v1/charts?authkey=[thekeyhughgaveyou]

Day

Top charts for the past 24 hours.

http://soundwaveapi.herokuapp.com/v1/charts/day?authkey=[thekeyhughgaveyou]

Week

Top charts for the past 7 days.

http://soundwaveapi.herokuapp.com/v1/charts/week?authkey=[thekeyhughgaveyou]

Month

Top charts for the past 4 weeks.

http://soundwaveapi.herokuapp.com/v1/charts/month?authkey=[thekeyhughgaveyou]

Scrobble stream

A websocket based firehose of all incoming scrobbles to Soundwave. To use, subscribe to

ws://soundwave.herokuapp.com/v1/scrobble-firehose

User Feed

The list of the songs that a user has listened to.

http://soundwaveapi.herokuapp.com/v1/userfeed/[email]?authkey=[thekeyhughgaveyou]

Questions?

Get in touch with Hugh! @hughrawlinson just about everywhere, @raw on the MHD slack, and sitting at the table nearest the door.

Clone this wiki locally