SoundCloud

App · 20 actions

Search SoundCloud, browse your tracks and followers, and create, update or delete playlists.

Actions

ActionWhat it does
Create playlistCreate playlist.
Delete playlistDelete playlist.
Get playlistGet playlist.
Get profileGet profile.
Get trackGet track.
Get userGet user.
List followersList followers.
List followingsList followings.
List liked tracksList liked tracks.
List my playlistsList my playlists.
List my tracksList my tracks.
List playlist tracksList playlist tracks.
List related tracksList related tracks.
List track commentsList track comments.
List user playlistsList user playlists.
List user tracksList user tracks.
Search playlistsSearch playlists.
Search tracksSearch tracks.
Search usersSearch users.
Update playlistUpdate playlist.

Create playlist

Create playlist.

Inputs

TitletitletextRequired
Title.
Descriptiondescriptiontext
Description.
Sharingsharingtext
Sharing.One of: private, public.
Trackstrack_urnslist
Tracks.

Outputs

dataobject
The service response, including pagination metadata when present.
Example output
{
  "data": {
    "artwork_url": "example",
    "created_at": "example",
    "description": "example",
    "downloadable": false,
    "duration": 1,
    "ean": "example",
    "embeddable_by": "example",
    "genre": "example",
    "kind": "example",
    "label": {
      "avatar_url": "example",
      "city": "example",
      "country": "example",
      "created_at": "example",
      "description": "example",
      "discogs_name": "example",
      "first_name": "example",
      "followers_count": 1,
      "followings_count": 1,
      "full_name": "example",
      "kind": "example",
      "last_modified": "example",
      "last_name": "example",
      "permalink": "example",
      "permalink_url": "example",
      "plan": "example",
      "playlist_count": 1,
      "public_favorites_count": 1,
      "reposts_count": 1,
      "station_urn": "example",
      "subscriptions": "example",
      "track_count": 1,
      "uri": "example",
      "urn": "example",
      "username": "example",
      "website": "example",
      "website_title": "example"
    },
    "label_id": 1,
    "label_name": "example",
    "last_modified": "example",
    "license": "example",
    "likes_count": 1,
    "permalink": "example",
    "permalink_url": "example",
    "playlist_type": "example",
    "purchase_title": "example",
    "purchase_url": "example",
    "release": "example",
    "release_day": 1,
    "release_month": 1,
    "release_year": 1,
    "sharing": "example",
    "streamable": false,
    "tag_list": "example",
    "tags": "example",
    "title": "example",
    "track_count": 1,
    "tracks": [],
    "tracks_uri": "example",
    "type": "example",
    "uri": "example",
    "urn": "example",
    "user": {
      "avatar_url": "example",
      "city": "example",
      "country": "example",
      "created_at": "example",
      "description": "example",
      "discogs_name": "example",
      "first_name": "example",
      "followers_count": 1,
      "followings_count": 1,
      "full_name": "example",
      "kind": "example",
      "last_modified": "example",
      "last_name": "example",
      "permalink": "example",
      "permalink_url": "example",
      "plan": "example",
      "playlist_count": 1,
      "public_favorites_count": 1,
      "reposts_count": 1,
      "station_urn": "example",
      "subscriptions": "example",
      "track_count": 1,
      "uri": "example",
      "urn": "example",
      "username": "example",
      "website": "example",
      "website_title": "example"
    },
    "user_urn": "example"
  }
}

Delete playlist

Delete playlist.

Inputs

Playlistplaylist_urntextRequired
Playlist.

Outputs

dataobject
The service response, including pagination metadata when present.
Example output
{
  "data": {}
}

Get playlist

Get playlist.

Inputs

Playlist urnplaylist_urntextRequired
User playlist URN or system playlist (station) URN. Examples: - User playlist: `soundcloud:playlists:1212781357` - System playlist (station): `soundcloud:system-playlists:track-stations:2287580618`
Accessaccesslist
Filters content by level of access the user (logged in or anonymous) has to the track. The result list will include only tracks with the specified access. Include all options if you'd like to see all possible tracks. See `Track#access` schema for more details.One or more of: playable, preview, blocked. Default: ["playable", "preview"].
Show tracksshow_trackstrue/false
A boolean flag to request a playlist with or without tracks. Default is `true`.

Outputs

dataobject
The service response, including pagination metadata when present.
Example output
{
  "data": {
    "artwork_url": "example",
    "created_at": "example",
    "description": "example",
    "downloadable": false,
    "duration": 1,
    "ean": "example",
    "embeddable_by": "example",
    "genre": "example",
    "kind": "example",
    "label": {
      "avatar_url": "example",
      "city": "example",
      "country": "example",
      "created_at": "example",
      "description": "example",
      "discogs_name": "example",
      "first_name": "example",
      "followers_count": 1,
      "followings_count": 1,
      "full_name": "example",
      "kind": "example",
      "last_modified": "example",
      "last_name": "example",
      "permalink": "example",
      "permalink_url": "example",
      "plan": "example",
      "playlist_count": 1,
      "public_favorites_count": 1,
      "reposts_count": 1,
      "station_urn": "example",
      "subscriptions": "example",
      "track_count": 1,
      "uri": "example",
      "urn": "example",
      "username": "example",
      "website": "example",
      "website_title": "example"
    },
    "label_id": 1,
    "label_name": "example",
    "last_modified": "example",
    "license": "example",
    "likes_count": 1,
    "permalink": "example",
    "permalink_url": "example",
    "playlist_type": "example",
    "purchase_title": "example",
    "purchase_url": "example",
    "release": "example",
    "release_day": 1,
    "release_month": 1,
    "release_year": 1,
    "sharing": "example",
    "streamable": false,
    "tag_list": "example",
    "tags": "example",
    "title": "example",
    "track_count": 1,
    "tracks": [],
    "tracks_uri": "example",
    "type": "example",
    "uri": "example",
    "urn": "example",
    "user": {
      "avatar_url": "example",
      "city": "example",
      "country": "example",
      "created_at": "example",
      "description": "example",
      "discogs_name": "example",
      "first_name": "example",
      "followers_count": 1,
      "followings_count": 1,
      "full_name": "example",
      "kind": "example",
      "last_modified": "example",
      "last_name": "example",
      "permalink": "example",
      "permalink_url": "example",
      "plan": "example",
      "playlist_count": 1,
      "public_favorites_count": 1,
      "reposts_count": 1,
      "station_urn": "example",
      "subscriptions": "example",
      "track_count": 1,
      "uri": "example",
      "urn": "example",
      "username": "example",
      "website": "example",
      "website_title": "example"
    },
    "user_urn": "example"
  }
}

Get profile

Get profile.

Inputs

None.

Outputs

dataobject
The service response, including pagination metadata when present.
Example output
{
  "data": {
    "avatar_url": "example",
    "city": "example",
    "comments_count": 1,
    "country": "example",
    "created_at": "example",
    "description": "example",
    "discogs_name": "example",
    "first_name": "example",
    "followers_count": 1,
    "followings_count": 1,
    "full_name": "example",
    "kind": "example",
    "last_modified": "example",
    "last_name": "example",
    "likes_count": 1,
    "locale": "example",
    "online": false,
    "permalink": "example",
    "permalink_url": "example",
    "plan": "example",
    "playlist_count": 1,
    "primary_email_confirmed": false,
    "private_playlists_count": 1,
    "private_tracks_count": 1,
    "public_favorites_count": 1,
    "quota": {
      "unlimited_upload_quota": false,
      "upload_seconds_left": 1,
      "upload_seconds_used": 1
    },
    "reposts_count": 1,
    "subscriptions": "example",
    "track_count": 1,
    "upload_seconds_left": 1,
    "uri": "example",
    "urn": "example",
    "username": "example",
    "website": "example",
    "website_title": "example"
  }
}

Get track

Get track.

Inputs

Track urntrack_urntextRequired
SoundCloud Track urn

Outputs

dataobject
The service response, including pagination metadata when present.
Example output
{
  "data": {
    "access": "playable",
    "artwork_url": "example",
    "available_country_codes": "example",
    "bpm": 1.0,
    "comment_count": 1,
    "commentable": false,
    "created_at": "example",
    "description": "example",
    "download_count": 1,
    "download_url": "example",
    "downloadable": false,
    "duration": 1,
    "embeddable_by": "example",
    "favoritings_count": 1,
    "genre": "example",
    "isrc": "example",
    "key_signature": "example",
    "kind": "example",
    "label_name": "example",
    "license": "example",
    "metadata_artist": "example",
    "permalink_url": "example",
    "playback_count": 1,
    "purchase_title": "example",
    "purchase_url": "example",
    "release": "example",
    "release_day": 1,
    "release_month": 1,
    "release_year": 1,
    "reposts_count": 1,
    "reveal_comments": false,
    "reveal_stats": false,
    "secret_uri": "example",
    "sharing": "example",
    "station_urn": "example",
    "stream_url": "example",
    "streamable": false,
    "tag_list": "example",
    "title": "example",
    "uri": "example",
    "urn": "example",
    "user": {
      "avatar_url": "example",
      "city": "example",
      "country": "example",
      "created_at": "example",
      "description": "example",
      "discogs_name": "example",
      "first_name": "example",
      "followers_count": 1,
      "followings_count": 1,
      "full_name": "example",
      "kind": "example",
      "last_modified": "example",
      "last_name": "example",
      "permalink": "example",
      "permalink_url": "example",
      "plan": "example",
      "playlist_count": 1,
      "public_favorites_count": 1,
      "reposts_count": 1,
      "station_urn": "example",
      "subscriptions": "example",
      "track_count": 1,
      "uri": "example",
      "urn": "example",
      "username": "example",
      "website": "example",
      "website_title": "example"
    },
    "user_favorite": false,
    "user_playback_count": 1,
    "waveform_url": "example"
  }
}

Get user

Get user.

Inputs

User urnuser_urntextRequired
SoundCloud User id

Outputs

dataobject
The service response, including pagination metadata when present.
Example output
{
  "data": {
    "avatar_url": "example",
    "city": "example",
    "country": "example",
    "created_at": "example",
    "description": "example",
    "discogs_name": "example",
    "first_name": "example",
    "followers_count": 1,
    "followings_count": 1,
    "full_name": "example",
    "kind": "example",
    "last_modified": "example",
    "last_name": "example",
    "permalink": "example",
    "permalink_url": "example",
    "plan": "example",
    "playlist_count": 1,
    "public_favorites_count": 1,
    "reposts_count": 1,
    "station_urn": "example",
    "subscriptions": "example",
    "track_count": 1,
    "uri": "example",
    "urn": "example",
    "username": "example",
    "website": "example",
    "website_title": "example"
  }
}

List followers

List followers.

Inputs

Limitlimitnumber
Number of results to return in the collection.From 1 to 200. Default: 50.

Outputs

dataobject
The service response, including pagination metadata when present.
Example output
{
  "data": {
    "collection": [],
    "next_href": "example"
  }
}

List followings

List followings.

Inputs

Limitlimitnumber
Number of results to return in the collection.From 1 to 200. Default: 50.
Offsetoffsetnumber
Offset of first result. Deprecated, use `linked_partitioning` instead.Default: 0.

Outputs

dataobject
The service response, including pagination metadata when present.
Example output
{
  "data": {
    "collection": [],
    "next_href": "example"
  }
}

List liked tracks

List liked tracks.

Inputs

Limitlimitnumber
Number of results to return in the collection.From 1 to 200. Default: 50.
Accessaccesslist
Filters content by level of access the user (logged in or anonymous) has to the track. The result list will include only tracks with the specified access. Include all options if you'd like to see all possible tracks. See `Track#access` schema for more details.One or more of: playable, preview, blocked. Default: ["playable", "preview", "blocked"].

Outputs

dataobject
The service response, including pagination metadata when present.
Example output
{
  "data": {
    "collection": [],
    "next_href": "example"
  }
}

List my playlists

List my playlists.

Inputs

Show tracksshow_trackstrue/false
A boolean flag to request a playlist with or without tracks. Default is `true`.
Limitlimitnumber
Number of results to return in the collection.From 1 to 200. Default: 50.

Outputs

dataobject
The service response, including pagination metadata when present.
Example output
{
  "data": {
    "collection": [],
    "next_href": "example"
  }
}

List my tracks

List my tracks.

Inputs

Limitlimitnumber
Number of results to return in the collection.From 1 to 200. Default: 50.

Outputs

dataobject
The service response, including pagination metadata when present.
Example output
{
  "data": {
    "collection": [],
    "next_href": "example"
  }
}

List playlist tracks

List playlist tracks.

Inputs

Playlist urnplaylist_urntextRequired
User playlist URN or system playlist (station) URN. Examples: - User playlist: `soundcloud:playlists:1212781357` - System playlist (station): `soundcloud:system-playlists:track-stations:2287580618`
Accessaccesslist
Filters content by level of access the user (logged in or anonymous) has to the track. The result list will include only tracks with the specified access. Include all options if you'd like to see all possible tracks. See `Track#access` schema for more details.One or more of: playable, preview, blocked. Default: ["playable", "preview"].

Outputs

dataobject
The service response, including pagination metadata when present.
Example output
{
  "data": {
    "collection": [],
    "next_href": "example"
  }
}

List related tracks.

Inputs

Track urntrack_urntextRequired
SoundCloud Track urn
Accessaccesslist
Filters content by level of access the user (logged in or anonymous) has to the track. The result list will include only tracks with the specified access. Include all options if you'd like to see all possible tracks. See `Track#access` schema for more details.One or more of: playable, preview, blocked. Default: ["playable", "preview"].
Limitlimitnumber
Number of results to return in the collection.From 1 to 200. Default: 50.
Offsetoffsetnumber
Offset of first result. Deprecated, use `linked_partitioning` instead.Default: 0.

Outputs

dataobject
The service response, including pagination metadata when present.
Example output
{
  "data": {
    "collection": [],
    "next_href": "example"
  }
}

List track comments

List track comments.

Inputs

Track urntrack_urntextRequired
SoundCloud Track urn
Limitlimitnumber
Number of results to return in the collection.From 1 to 200. Default: 50.
Offsetoffsetnumber
Offset of first result. Deprecated, use `linked_partitioning` instead.Default: 0.

Outputs

dataobject
The service response, including pagination metadata when present.
Example output
{
  "data": {
    "collection": [],
    "next_href": "example"
  }
}

List user playlists

List user playlists.

Inputs

User urnuser_urntextRequired
SoundCloud User id
Accessaccesslist
Filters content by level of access the user (logged in or anonymous) has to the track. The result list will include only tracks with the specified access. Include all options if you'd like to see all possible tracks. See `Track#access` schema for more details.One or more of: playable, preview, blocked. Default: ["playable", "preview"].
Show tracksshow_trackstrue/false
A boolean flag to request a playlist with or without tracks. Default is `true`.
Limitlimitnumber
Number of results to return in the collection.From 1 to 200. Default: 50.

Outputs

dataobject
The service response, including pagination metadata when present.
Example output
{
  "data": {
    "collection": [],
    "next_href": "example"
  }
}

List user tracks

List user tracks.

Inputs

User urnuser_urntextRequired
SoundCloud User id
Accessaccesslist
Filters content by level of access the user (logged in or anonymous) has to the track. The result list will include only tracks with the specified access. Include all options if you'd like to see all possible tracks. See `Track#access` schema for more details.One or more of: playable, preview, blocked. Default: ["playable", "preview"].
Limitlimitnumber
Number of results to return in the collection.From 1 to 200. Default: 50.

Outputs

dataobject
The service response, including pagination metadata when present.
Example output
{
  "data": {
    "collection": [],
    "next_href": "example"
  }
}

Search playlists

Search playlists.

Inputs

Qqtext
search
Accessaccesslist
Filters content by level of access the user (logged in or anonymous) has to the track. The result list will include only tracks with the specified access. Include all options if you'd like to see all possible tracks. See `Track#access` schema for more details.One or more of: playable, preview, blocked. Default: ["playable", "preview"].
Show tracksshow_trackstrue/false
A boolean flag to request a playlist with or without tracks. Default is `true`.
Limitlimitnumber
Number of results to return in the collection.From 1 to 200. Default: 50.
Offsetoffsetnumber
Offset of first result. Deprecated, use `linked_partitioning` instead.Default: 0.

Outputs

dataobject
The service response, including pagination metadata when present.
Example output
{
  "data": {
    "collection": [],
    "next_href": "example"
  }
}

Search tracks

Search tracks.

Inputs

Qqtext
search
Accessaccesslist
Filters content by level of access the user (logged in or anonymous) has to the track. The result list will include only tracks with the specified access. Include all options if you'd like to see all possible tracks. See `Track#access` schema for more details.One or more of: playable, preview, blocked. Default: ["playable", "preview"].
Limitlimitnumber
Number of results to return in the collection.From 1 to 200. Default: 50.
Offsetoffsetnumber
Offset of first result. Deprecated, use `linked_partitioning` instead.Default: 0.

Outputs

dataobject
The service response, including pagination metadata when present.
Example output
{
  "data": {
    "collection": [],
    "next_href": "example"
  }
}

Search users

Search users.

Inputs

Qqtext
search
Limitlimitnumber
Number of results to return in the collection.From 1 to 200. Default: 50.
Offsetoffsetnumber
Offset of first result. Deprecated, use `linked_partitioning` instead.Default: 0.

Outputs

dataobject
The service response, including pagination metadata when present.
Example output
{
  "data": {
    "collection": [],
    "next_href": "example"
  }
}

Update playlist

Update playlist.

Inputs

Playlistplaylist_urntextRequired
Playlist.
Titletitletext
Title.
Descriptiondescriptiontext
Description.
Sharingsharingtext
Sharing.One of: private, public.
Trackstrack_urnslist
Tracks.

Outputs

dataobject
The service response, including pagination metadata when present.
Example output
{
  "data": {
    "artwork_url": "example",
    "created_at": "example",
    "description": "example",
    "downloadable": false,
    "duration": 1,
    "ean": "example",
    "embeddable_by": "example",
    "genre": "example",
    "kind": "example",
    "label": {
      "avatar_url": "example",
      "city": "example",
      "country": "example",
      "created_at": "example",
      "description": "example",
      "discogs_name": "example",
      "first_name": "example",
      "followers_count": 1,
      "followings_count": 1,
      "full_name": "example",
      "kind": "example",
      "last_modified": "example",
      "last_name": "example",
      "permalink": "example",
      "permalink_url": "example",
      "plan": "example",
      "playlist_count": 1,
      "public_favorites_count": 1,
      "reposts_count": 1,
      "station_urn": "example",
      "subscriptions": "example",
      "track_count": 1,
      "uri": "example",
      "urn": "example",
      "username": "example",
      "website": "example",
      "website_title": "example"
    },
    "label_id": 1,
    "label_name": "example",
    "last_modified": "example",
    "license": "example",
    "likes_count": 1,
    "permalink": "example",
    "permalink_url": "example",
    "playlist_type": "example",
    "purchase_title": "example",
    "purchase_url": "example",
    "release": "example",
    "release_day": 1,
    "release_month": 1,
    "release_year": 1,
    "sharing": "example",
    "streamable": false,
    "tag_list": "example",
    "tags": "example",
    "title": "example",
    "track_count": 1,
    "tracks": [],
    "tracks_uri": "example",
    "type": "example",
    "uri": "example",
    "urn": "example",
    "user": {
      "avatar_url": "example",
      "city": "example",
      "country": "example",
      "created_at": "example",
      "description": "example",
      "discogs_name": "example",
      "first_name": "example",
      "followers_count": 1,
      "followings_count": 1,
      "full_name": "example",
      "kind": "example",
      "last_modified": "example",
      "last_name": "example",
      "permalink": "example",
      "permalink_url": "example",
      "plan": "example",
      "playlist_count": 1,
      "public_favorites_count": 1,
      "reposts_count": 1,
      "station_urn": "example",
      "subscriptions": "example",
      "track_count": 1,
      "uri": "example",
      "urn": "example",
      "username": "example",
      "website": "example",
      "website_title": "example"
    },
    "user_urn": "example"
  }
}

On this page