SoundCloud for Developers

Discover, connect and build

oEmbed

Introduction

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 oEmbed.com.

Endpoint

The SoundCloud oEmbed endpoint is located at

http://soundcloud.com/oembed
It accepts any URL pointing to a user, group, set or track and supports JSON (CORS), JSONP and XML (default) as a response format.

A basic request / response example:

$ curl "http://soundcloud.com/oembed" \\
           -d 'format=json' \\
           -d 'url=http://soundcloud.com/forss/flickermood'
{
  "version": 1.0,
  "type": "rich",
  "provider_name": "Soundcloud",
  "provider_url": "http://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, group, user.
format json (optional) Either xml, 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.