Reading tracks and playlists from Soundcloud

WavePlayer 3 gives you the ability to read your favorite tracks or playlists directly from Soundcloud, incorporating them into your website without worrying about the visual aspect of the player not fully matching the style of your page. With WavePlayer you are always in full control.

Adding tracks or playlists from Soundcloud

Adding a single track or a full playlist is as easy as copying the URL of the track or playlist from Soundcloud…

Copy the URL of a playlist from Soundcloud

…and paste it in the URL field of the WavePlayer instance you are creating (in the following picture you can see a Gutenberg Block but this method is valid for an Elementor widget, as well as the Classic Editor and the regular WavePlayer shortcode).

Paste the URL of the Soundcloud playlist to the WavePlayer block

What WavePlayer does is reading the track information directly from Soundcloud, including the URL of the audio files, the titles, the artists, even the thumbnails. It then generates a single-track instance or a playlist based on the data retrieved from Soundcloud.

With this method, you don’t have to worry about updating your posts or pages of your website every time a playlist changes. WavePlayer automatically updates the playlist on your page every time a visitor loads it. The following player shows the content of this playlist from Soundcloud.

How waveform are generated

When you load a track from Soundcloud that was never played back before, WavePlayer analyzes the audio file and generates a peak file, storing it in the /wp-content/uploads/peaks/soundcloud folder. Since Soundcloud uniquely identifies each track with an ID, WavePlayer uses that to name the peak file so that, every subsequent time the same track is loaded in the player, the rendering of the waveform can be nearly instantaneous.

It is worth noting that, unlike the waveform on Soundcloud that are stored as PNG image files, WavePlayer stores the waveform information as an array of sample values. The number of samples is large enough to guarantee a high-resolution rendering even on the largest screen and when the player occupies the full width of the browser. The use of peak files makes it also possible to render the same waveform with different visual configuration without any need to regenerate the peak file. For example, the following players show the waveform of the same audio track with different visual configurations. All players use the same peak file.

This answer in the FAQ offers more details about the peak files.


Soundcloud closed the registration of new apps, which used to be the process through which you could request your own API Client ID. The API Client ID is necessary to access the tracks information on the Soundcloud server. If you don’t have your own Soundcloud API Client ID, WavePlayer can use its own internal client ID. Unfortunately, starting from July 1, 2015, Soundcloud limited the number of API calls to 15,000 a day.

If you have already registered your app and received your own API Client ID, we strongly recommend using your API Client ID. This way, the 15,000 calls a day will be reserved for your uses only. If you don’t have any registered app with your Soundcloud account, you cannot registered a new one now because Soundcloud closed the registration of new apps and has no plan in reopening the registration soon, as it is possible to read in the registration form.

Due to the high amount of requests recently received, we will no longer be processing API application requests at this time. We are working to re-evaluate our process to make it more efficient.

SoundCloud Application Registration

Please be aware that, in case you don’t have your own SoundCloud API Client ID, the limit of 15,000 calls a day for the Client ID distributed with WavePlayer will be covering the whole WavePlayer customer base. With the growing number of customers, this fact could lead to reaching the API calls limit pretty fast and cause interruptions of service.

We wish SoundCloud allows the registration of new apps soon. In the meantime, the best we could do is sharing with all our customers our own SoundCloud API Client ID.

Powered by BetterDocs