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 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, group, set or a playlist. To find out more about the oEmbed standard, have a look at


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

A basic request / response example:

$ curl "" \\           -d 'format=json' \\           -d 'url='
  "version": 1.0,
  "type": "rich",
  "provider_name": "Soundcloud",
  "provider_url": "",
  "height": 81,
  "width": "100%",
  "title": "Flickermood by Forss",
  "description": "test",
  "html": "test"


Name Default Description
url - A Soundcloud URL for a track, set, group, 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 81 or 305 (optional) The maximum height in px. The default is 81 for tracks and 305 for all other.
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.
iframe true (optional) Whether the new HTML5 Iframe-based Widget or the old Adobe Flash Widget will be returned.