Skip to content

SoundSystem API

gordielachance edited this page Sep 9, 2020 · 14 revisions

Alongside with the WP SoundSystem plugin, an API has been developed in Ruby.

It was originally built to add a tracklist importer feature to the WP SoundSystem plugin, by getting standardized datas from various music services like Spotify, Last.fm, Musicbrainz, and many more – it even works with your own CSS selectors !

It is also used by the plugin to get playable audio sources automatically for a track (Youtube, Soundcloud, …), etc.

If you have installed the WP SoundSystem plugin, or if you are developing a music app, you definitely want to get an API key !

It took a huge amount of time to develop both the API and the plugin. While the WP SoundSystem plugin is free, this API isn’t: it is a way to try to monetize all the work done, to keep the project alive.

The actual price is 50$/year. Test it first! Get a free demo day by giving the plugin a rating on wordpress.org.

By buying an API key, you do understand that some features of this API depend on external services, and might stop or evolve.
We will do our best to offer you the best experience possible.

Just contact me if you have any questions, or pay what you need here, and I'll create your API key.

Thanks !

PS: The WP SoundSystem plugin WILL work fine without API key. It just adds some nice features, and it is a way to support the work done – hundred of hours – , and to ensure its durability.

Endpoints

  • /importers (no auth needed) : get a list of the available importers
  • /importer (no auth needed) : get a single importer. Parameters : url or slug
  • /auth/token get the token required to make an API request
  • /auth/userdata get datas on the current user
  • /tracklist/import import an URL and returns a JSPF tracklist. Parameters : url; optionnals parameters: options
  • /track/links gets the URLs of playable sources for a track. Parameters : spotify_id
Clone this wiki locally