SoundCloud for Developers

Discover, connect and build

We use cookies for various purposes including analytics and personalized marketing. By continuing to use the service, you agree to our use of cookies as described in the Cookie Policy.

oEmbed

oEmbed is an open standard to easily embed content from oEmbed providers into your site. The SoundCloud oEmbed endpoint will serve the widget embed code for any SoundCloud URL pointing to a user, set, or a playlist. To find out more about the oEmbed standard, have a look at oEmbed.com.

The SoundCloud oEmbed endpoint is located at. It accepts any URL pointing to a user, set or track and supports JSON (CORS) and JSONP as a response format.

https://soundcloud.com/oembed

A basic request / response example:

$ curl "https://soundcloud.com/oembed" \\           -d 'format=json' \\           -d 'url=https://soundcloud.com/forss/flickermood'
{
  "version": 1.0,
  "type": "rich",
  "provider_name": "Soundcloud",
  "provider_url": "https://soundcloud.com",
  "height": 81,
  "width": "100%",
  "title": "Flickermood by Forss",
  "description": "test",
  "html": "test"
}

Parameters

Name Default Description
url - A Soundcloud URL for a track, set, user.
format json (optional) Either json or js (for JSONP).
callback - (optional) A function name for the JSONP callback .
maxwidth 100% (optional) The maximum width in px.
maxheight 166 or 450 (optional) The maximum height in px. The default is 166px for tracks and 450px for sets. If using the flash widget, the default is 81px for tracks and 305px for sets.
color - (optional) The primary color of the widget as a hex triplet. (For example: ff0066).
auto_play false (optional) Whether the widget plays on load.
show_comments true (optional) Whether the player displays timed comments.