SoundCloud Public API Specification

Music and audio streaming platform

Version

1.0.0

OpenAPI

3.0.3

Endpoints

Schemas

65

Quality

Updated

3 days ago

Music music streaming audio

Use this API in your AI agent

Query structured spec data via REST or MCP. Get exactly what your agent needs.

Get API Key

Server URLs

https://api.soundcloud.com

Endpoints

GET POST PUT PATCH DELETE

Likes 4 endpoints

DELETE /likes/playlists/{playlist_id} Unlikes a playlist.

operationId: Likes_unlikePlaylist

Parameters

Name	In	Required	Type	Description
playlist_id	path	optional	integer	SoundCloud playlist id

Responses

200

Success

400

Bad Request

404

Not Found

DELETE /likes/playlists/{playlist_id}

POST /likes/playlists/{playlist_id} Likes a playlist.

operationId: Likes_playlist

Parameters

Name	In	Required	Type	Description
playlist_id	path	optional	integer	SoundCloud playlist id

Responses

200

Success

400

Bad Request

401

Unauthorized

404

Not Found

429

Too Many Requests

POST /likes/playlists/{playlist_id}

DELETE /likes/tracks/{track_id} Unlikes a track.

operationId: Likes_unlikeTrack

Parameters

Name	In	Required	Type	Description
track_id	path	optional	integer	SoundCloud Track id

Responses

200

Success

400

Bad Request

404

Not Found

DELETE /likes/tracks/{track_id}

POST /likes/tracks/{track_id} Likes a track.

operationId: Likes_trackAction

Parameters

Name	In	Required	Type	Description
track_id	path	optional	integer	SoundCloud Track id

Responses

200

Success

400

Bad Request

401

Unauthorized

404

Not Found

429

Too Many Requests

POST /likes/tracks/{track_id}

Me 13 endpoints

GET /me Returns the authenticated user’s information.

operationId: Me_getUserInformation

Responses

200

Success

401

Unauthorized

GET /me

GET /me/activities Returns the authenticated user's activities.

operationId: Me_getActivities

Parameters

Name	In	Required	Type	Description
access	query	optional	array	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.
limit	query	optional	integer	Number of results to return in the collection.

Responses

200

Success

401

Unauthorized

GET /me/activities

GET /me/activities/all/own Recent the authenticated user's activities.

operationId: Me_getRecentActivities

Parameters

Name	In	Required	Type	Description
access	query	optional	array	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.
limit	query	optional	integer	Number of results to return in the collection.

Responses

200

Success

401

Unauthorized

GET /me/activities/all/own

GET /me/activities/tracks Returns the authenticated user's recent track related activities.

operationId: Me_getRecentTracks

Parameters

Name	In	Required	Type	Description
access	query	optional	array	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.
limit	query	optional	integer	Number of results to return in the collection.

Responses

200

Success

401

Unauthorized

GET /me/activities/tracks

GET /me/followers Returns a list of users who are following the authenticated user.

operationId: Me_getFollowersList

Parameters

Name	In	Required	Type	Description
limit	query	optional	integer	Number of results to return in the collection.

Responses

200

Success

401

Unauthorized

GET /me/followers

GET /me/followings Returns a list of users who are followed by the authenticated user.

operationId: Me_getFollowedUsers

Parameters

Name	In	Required	Type	Description
limit	query	optional	integer	Number of results to return in the collection.
offset	query	optional	integer	Offset of first result. Deprecated, use `linked_partitioning` instead.

Responses

200

Success

401

Unauthorized

GET /me/followings

GET /me/followings/tracks Returns a list of recent tracks from users followed by the authenticated user.

operationId: Me_listFollowedTracks

Parameters

Name	In	Required	Type	Description
access	query	optional	array	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.
limit	query	optional	integer	Number of results to return in the collection.
offset	query	optional	integer	Offset of first result. Deprecated, use `linked_partitioning` instead.

Responses

200

Success

401

Unauthorized

GET /me/followings/tracks

DELETE /me/followings/{user_id} Deletes a user who is followed by the authenticated user.

operationId: Me_deleteFollowedUser

Parameters

Name	In	Required	Type	Description
user_id	path	optional	integer	SoundCloud User id

Responses

200

Success

401

Unauthorized

404

Not Found

422

Unprocessable Entity

DELETE /me/followings/{user_id}

PUT /me/followings/{user_id} Follows a user.

operationId: Me_followUser

Parameters

Name	In	Required	Type	Description
user_id	path	optional	integer	SoundCloud User id

Responses

200

Success

201

Success

401

Unauthorized

404

Not Found

PUT /me/followings/{user_id}

GET /me/likes/playlists Returns a list of favorited or liked playlists of the authenticated user.

operationId: Me_getLikedPlaylists

Parameters

Name	In	Required	Type	Description
limit	query	optional	integer	Number of results to return in the collection.
linked_partitioning	query	optional	boolean	Returns paginated collection of items (recommended, returning a list without pagination is deprecated and should not be used)

Responses

200

Success

401

Unauthorized

GET /me/likes/playlists

GET /me/likes/tracks Returns a list of favorited or liked tracks of the authenticated user.

operationId: Me_listLikedTracks

Parameters

Name	In	Required	Type	Description
limit	query	optional	integer	Number of results to return in the collection.
access	query	optional	array	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.
linked_partitioning	query	optional	boolean	Returns paginated collection of items (recommended, returning a list without pagination is deprecated and should not be used)

Responses

200

Success

401

Unauthorized

GET /me/likes/tracks

GET /me/playlists Returns user’s playlists (sets).

Returns playlist info, playlist tracks and tracks owner info.

operationId: Me_listPlaylistsInfoTracksOwner

Parameters

Name	In	Required	Type	Description
show_tracks	query	optional	boolean	A boolean flag to request a playlist with or without tracks. Default is `true`.
linked_partitioning	query	optional	boolean	Returns paginated collection of items (recommended, returning a list without pagination is deprecated and should not be used)
limit	query	optional	integer	Number of results to return in the collection.

Responses

200

Success

401

Unauthorized

404

Not Found

GET /me/playlists

GET /me/tracks Returns a list of user's tracks.

operationId: Me_listUserTracks

Parameters

Name	In	Required	Type	Description
limit	query	optional	integer	Number of results to return in the collection.
linked_partitioning	query	optional	boolean	Returns paginated collection of items (recommended, returning a list without pagination is deprecated and should not be used)

Responses

200

Success

401

Unauthorized

GET /me/tracks

Miscellaneous 1 endpoints

GET /resolve Resolves soundcloud.com and on.soundcloud.com URLs to Resource URLs to use with the API.

operationId: Miscellaneous_resolveSoundcloudUrls

Parameters

Name	In	Required	Type	Description
url	query	optional	string	SoundCloud URL

Responses

200

302

Found

404

Not Found

GET /resolve

Oauth 2 endpoints

GET /connect The OAuth2 authorization endpoint. Your app redirects a user to this endpoint, allowing them to delegate access to their account.

Security Advice

OAuth Authorization Code flow (response_type=code) is the only allowed method of authorization.
Use the state parameter for CSRF protection. Pass a sufficient random nonce here and verify this nonce again after retrieving the token.

operationId: Oauth_authorizeUser

Parameters

Name	In	Required	Type	Description
client_id	query	optional	string	The client id belonging to your application
redirect_uri	query	optional	string	The redirect uri you have configured for your application
response_type	query	optional	string	Support only the Authorization Code Flow
state	query	optional	string	Any value included here will be appended to the redirect URI. Use this for CSRF protection.

Responses

200

302

Redirect to connect portal

401

Unauthorized

GET /connect

POST /oauth2/token This endpoint accepts POST requests and is used to provision access tokens once a user has authorized your application.

operationId: Oauth_provisionAccessToken

Request Body

required

multipart/form-data

schema OAuthToken

Property	Type	Required
code	string	optional
client_id	string	required
grant_type	string	required
redirect_uri	string	optional
client_secret	string	required
refresh_token	string	optional

application/x-www-form-urlencoded

schema OAuthToken

Property	Type	Required
code	string	optional
client_id	string	required
grant_type	string	required
redirect_uri	string	optional
client_secret	string	required
refresh_token	string	optional

Responses

200

Success

400

Bad Request

401

Unauthorized

POST /oauth2/token

Playlists 6 endpoints

POST /playlists Creates a playlist.

operationId: Playlists_createNewPlaylist

Request Body

Create Playlist request

application/json

schema CreateUpdatePlaylistRequest

Property	Type	Required
playlist	object	optional
└ ean	string	optional
└ genre	string	optional
└ title	string	optional
└ tracks	array	optional
└ id	string	required
└ license	string	optional
└ release	string	optional
└ sharing	string	optional
└ set_type	string	optional
└ tag_list	string	optional
└ permalink	string	optional
└ label_name	string	optional
└ description	string	optional
└ artwork_data	string	optional
└ purchase_url	string	optional
└ release_date	string	optional
└ permalink_url	string	optional
└ purchase_title	string	optional

multipart/form-data

schema PlaylistsCreateNewPlaylistRequest

Property	Type	Required
playlist[ean]	string	optional
playlist[genre]	string	optional
playlist[title]	string	required
playlist[license]	string	optional
playlist[release]	string	optional
playlist[sharing]	string	optional
playlist[set_type]	string	optional
playlist[tag_list]	string	optional
playlist[permalink]	string	optional
playlist[label_name]	string	optional
playlist[description]	string	optional
playlist[artwork_data]	string	optional
playlist[purchase_url]	string	optional
playlist[release_date]	string	optional
playlist[tracks][][id]	string	optional
playlist[permalink_url]	string	optional
playlist[purchase_title]	string	optional

Responses

201

Success

401

Unauthorized

404

Not Found

POST /playlists

DELETE /playlists/{playlist_id} Deletes a playlist.

operationId: Playlists_deletePlaylist

Parameters

Name	In	Required	Type	Description
playlist_id	path	optional	integer	SoundCloud playlist id

Responses

200

Success

404

Not Found

DELETE /playlists/{playlist_id}

GET /playlists/{playlist_id} Returns a playlist.

operationId: Playlists_getPlaylistById

Parameters

Name	In	Required	Type	Description
playlist_id	path	optional	integer	SoundCloud playlist id
secret_token	query	optional	string	A secret token to fetch private playlists/tracks
access	query	optional	array	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.
show_tracks	query	optional	boolean	A boolean flag to request a playlist with or without tracks. Default is `true`.

Responses

200

Success

400

Bad Request

401

Unauthorized

GET /playlists/{playlist_id}

PUT /playlists/{playlist_id} Updates a playlist.

operationId: Playlists_updatePlaylistById

Parameters

Name	In	Required	Type	Description
playlist_id	path	optional	integer	SoundCloud playlist id

Request Body

Playlist payload

application/json

schema CreateUpdatePlaylistRequest

Property	Type	Required
playlist	object	optional
└ ean	string	optional
└ genre	string	optional
└ title	string	optional
└ tracks	array	optional
└ id	string	required
└ license	string	optional
└ release	string	optional
└ sharing	string	optional
└ set_type	string	optional
└ tag_list	string	optional
└ permalink	string	optional
└ label_name	string	optional
└ description	string	optional
└ artwork_data	string	optional
└ purchase_url	string	optional
└ release_date	string	optional
└ permalink_url	string	optional
└ purchase_title	string	optional

Responses

200

Success

401

Unauthorized

404

Not Found

PUT /playlists/{playlist_id}

GET /playlists/{playlist_id}/reposters Returns a collection of playlist's reposters.

operationId: Playlists_listReposters

Parameters

Name	In	Required	Type	Description
playlist_id	path	optional	integer	SoundCloud playlist id
limit	query	optional	integer	Number of results to return in the collection.

Responses

200

Success

401

Unauthorized

404

Not Found

GET /playlists/{playlist_id}/reposters

GET /playlists/{playlist_id}/tracks Returns tracks under a playlist.

operationId: Playlists_getTracks

Parameters

Name	In	Required	Type	Description
playlist_id	path	optional	integer	SoundCloud playlist id
secret_token	query	optional	string	A secret token to fetch private playlists/tracks
access	query	optional	array	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.
linked_partitioning	query	optional	boolean	Returns paginated collection of items (recommended, returning a list without pagination is deprecated and should not be used)

Responses

200

Success

400

Bad Request

401

Unauthorized

GET /playlists/{playlist_id}/tracks

Reposts 4 endpoints

DELETE /reposts/playlists/{playlist_id} Removes a repost on a playlist as the authenticated user

operationId: Reposts_removeRepostOnPlaylist

Parameters

Name	In	Required	Type	Description
playlist_id	path	optional	integer	SoundCloud playlist id

Responses

200

Success

401

Unauthorized

404

Not Found

DELETE /reposts/playlists/{playlist_id}

POST /reposts/playlists/{playlist_id} Reposts a playlist as the authenticated user

operationId: Reposts_playlistAsAuthenticatedUser

Parameters

Name	In	Required	Type	Description
playlist_id	path	optional	integer	SoundCloud playlist id

Responses

201

Created

401

Unauthorized

404

Not Found

POST /reposts/playlists/{playlist_id}

DELETE /reposts/tracks/{track_id} Removes a repost on a track as the authenticated user

operationId: Reposts_removeRepost

Parameters

Name	In	Required	Type	Description
track_id	path	optional	integer	SoundCloud Track id

Responses

200

Success

401

Unauthorized

404

Not Found

DELETE /reposts/tracks/{track_id}

POST /reposts/tracks/{track_id} Reposts a track as the authenticated user

operationId: Reposts_trackAsAuthenticatedUser

Parameters

Name	In	Required	Type	Description
track_id	path	optional	integer	SoundCloud Track id

Responses

201

Created

401

Unauthorized

404

Not Found

POST /reposts/tracks/{track_id}

Search 3 endpoints

GET /playlists Performs a playlist search based on a query

operationId: Search_byQuery

Parameters

Name	In	Required	Type	Description
q	query	optional	string	search
access	query	optional	array	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.
show_tracks	query	optional	boolean	A boolean flag to request a playlist with or without tracks. Default is `true`.
limit	query	optional	integer	Number of results to return in the collection.
offset	query	optional	integer	Offset of first result. Deprecated, use `linked_partitioning` instead.
linked_partitioning	query	optional	boolean	Returns paginated collection of items (recommended, returning a list without pagination is deprecated and should not be used)

Responses

200

Success

400

Bad Request

401

Unauthorized

GET /playlists

GET /tracks Performs a track search based on a query

operationId: Search_byQuery

Parameters

Name	In	Required	Type	Description
q	query	optional	string	search
ids	query	optional	string	A comma separated list of track ids to filter on
genres	query	optional	string	A comma separated list of genres
tags	query	optional	string	A comma separated list of tags
bpm	query	optional	object	Return tracks with a specified bpm[from], bpm[to]
duration	query	optional	object	Return tracks within a specified duration range
created_at	query	optional	object	(yyyy-mm-dd hh:mm:ss) return tracks created within the specified dates
access	query	optional	array	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.
limit	query	optional	integer	Number of results to return in the collection.
offset	query	optional	integer	Offset of first result. Deprecated, use `linked_partitioning` instead.
linked_partitioning	query	optional	boolean	Returns paginated collection of items (recommended, returning a list without pagination is deprecated and should not be used)

Responses

200

Success

400

Bad Request

401

Unauthorized

500

Internal Server Error

GET /tracks

GET /users Performs a user search based on a query

operationId: Search_userQuery

Parameters

Name	In	Required	Type	Description
q	query	optional	string	search
ids	query	optional	string	A comma separated list of track ids to filter on
limit	query	optional	integer	Number of results to return in the collection.
offset	query	optional	integer	Offset of first result. Deprecated, use `linked_partitioning` instead.
linked_partitioning	query	optional	boolean	Returns paginated collection of items (recommended, returning a list without pagination is deprecated and should not be used)

Responses

200

Success

400

Bad Request

401

Unauthorized

GET /users

Tracks 10 endpoints

POST /tracks Uploads a new track.

operationId: Tracks_uploadNewTrack

Request Body

multipart/form-data

schema TracksUploadNewTrackRequest

Property	Type	Required
track[isrc]	string	optional
track[genre]	string	optional
track[title]	string	required
track[license]	string	optional
track[release]	string	optional
track[sharing]	string	optional
track[tag_list]	string	optional
track[permalink]	string	optional
track[asset_data]	string	required
track[label_name]	string	optional
track[streamable]	boolean	optional
track[commentable]	boolean	optional
track[description]	string	optional
track[artwork_data]	string	optional
track[downloadable]	boolean	optional
track[purchase_url]	string	optional
track[release_date]	string	optional
track[embeddable_by]	string	optional

multipart/x-www-form-urlencoded

schema TracksUploadNewTrackRequest1

Property	Type	Required
track[isrc]	string	optional
track[genre]	string	optional
track[title]	string	required
track[license]	string	optional
track[release]	string	optional
track[sharing]	string	optional
track[tag_list]	string	optional
track[permalink]	string	optional
track[asset_data]	string	required
track[label_name]	string	optional
track[streamable]	boolean	optional
track[commentable]	boolean	optional
track[description]	string	optional
track[artwork_data]	string	optional
track[downloadable]	boolean	optional
track[purchase_url]	string	optional
track[release_date]	string	optional
track[embeddable_by]	string	optional

Responses

201

Success

400

Bad Request

401

Unauthorized

422

Unprocessable Entity

POST /tracks

DELETE /tracks/{track_id} Deletes a track.

operationId: Tracks_deleteTrack

Parameters

Name	In	Required	Type	Description
track_id	path	optional	integer	SoundCloud Track id

Responses

200

Success

404

Not Found

DELETE /tracks/{track_id}

GET /tracks/{track_id} Returns a track.

operationId: Tracks_getById

Parameters

Name	In	Required	Type	Description
track_id	path	optional	integer	SoundCloud Track id
secret_token	query	optional	string	A secret token to fetch private playlists/tracks

Responses

200

Success

401

Unauthorized

404

Not Found

GET /tracks/{track_id}

PUT /tracks/{track_id} Updates a track's information.

operationId: Tracks_updateTrackInformation

Parameters

Name	In	Required	Type	Description
track_id	path	optional	integer	SoundCloud Track id

Request Body

Track payload

application/json

schema TrackMetadataRequest

Property	Type	Required
track	object	optional
└ isrc	string	optional
└ genre	string	optional
└ title	string	optional
└ license	string	optional
└ release	string	optional
└ sharing	string	optional
└ tag_list	string	optional
└ permalink	string	optional
└ label_name	string	optional
└ streamable	boolean	optional
└ commentable	boolean	optional
└ description	string	optional
└ downloadable	boolean	optional
└ purchase_url	string	optional
└ release_date	string	optional
└ embeddable_by	string	optional

multipart/form-data

schema TrackDataRequest

Property	Type	Required
track[isrc]	string	optional
track[genre]	string	optional
track[title]	string	optional
track[license]	string	optional
track[release]	string	optional
track[sharing]	string	optional
track[tag_list]	string	optional
track[permalink]	string	optional
track[asset_data]	string	optional
track[label_name]	string	optional
track[streamable]	boolean	optional
track[commentable]	boolean	optional
track[description]	string	optional
track[artwork_data]	string	optional
track[downloadable]	boolean	optional
track[purchase_url]	string	optional
track[release_date]	string	optional
track[embeddable_by]	string	optional

multipart/x-www-form-urlencoded

schema TrackDataRequest

Property	Type	Required
track[isrc]	string	optional
track[genre]	string	optional
track[title]	string	optional
track[license]	string	optional
track[release]	string	optional
track[sharing]	string	optional
track[tag_list]	string	optional
track[permalink]	string	optional
track[asset_data]	string	optional
track[label_name]	string	optional
track[streamable]	boolean	optional
track[commentable]	boolean	optional
track[description]	string	optional
track[artwork_data]	string	optional
track[downloadable]	boolean	optional
track[purchase_url]	string	optional
track[release_date]	string	optional
track[embeddable_by]	string	optional

Responses

200

Success

400

Bad Request

401

Unauthorized

PUT /tracks/{track_id}

GET /tracks/{track_id}/comments Returns the comments posted on the track(track_id).

operationId: Tracks_getComments

Parameters

Name	In	Required	Type	Description
track_id	path	optional	integer	SoundCloud Track id
limit	query	optional	integer	Number of results to return in the collection.
offset	query	optional	integer	Offset of first result. Deprecated, use `linked_partitioning` instead.
linked_partitioning	query	optional	boolean	Returns paginated collection of items (recommended, returning a list without pagination is deprecated and should not be used)

Responses

200

Success

401

Unauthorized

404

Not Found

GET /tracks/{track_id}/comments

POST /tracks/{track_id}/comments Returns the newly created comment on success

operationId: Tracks_createComment

Parameters

Name	In	Required	Type	Description
track_id	path	optional	integer	SoundCloud Track id

Request Body

required

Body of a comment

application/json; charset=utf-8

schema TracksCreateCommentRequest

Property	Type	Required
comment	object	optional
└ body	string	required
└ timestamp	object	optional

Responses

201

Success

422

Unprocessable Entity

429

Too Many Requests

POST /tracks/{track_id}/comments

GET /tracks/{track_id}/favoriters Returns a list of users who have favorited or liked the track.

operationId: Tracks_getFavoriters

Parameters

Name	In	Required	Type	Description
track_id	path	optional	integer	SoundCloud Track id
limit	query	optional	integer	Number of results to return in the collection.
linked_partitioning	query	optional	boolean	Returns paginated collection of items (recommended, returning a list without pagination is deprecated and should not be used)

Responses

200

Success

401

Unauthorized

404

Not Found

GET /tracks/{track_id}/favoriters

GET /tracks/{track_id}/related Returns all related tracks of track on SoundCloud.

operationId: Tracks_getRelatedTracks

Parameters

Name	In	Required	Type	Description
track_id	path	optional	integer	SoundCloud Track id
access	query	optional	array	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.
limit	query	optional	integer	Number of results to return in the collection.
offset	query	optional	integer	Offset of first result. Deprecated, use `linked_partitioning` instead.
linked_partitioning	query	optional	boolean	Returns paginated collection of items (recommended, returning a list without pagination is deprecated and should not be used)

Responses

200

Success

401

Unauthorized

404

Not Found

GET /tracks/{track_id}/related

GET /tracks/{track_id}/reposters Returns a collection of track's reposters.

operationId: Tracks_listReposters

Parameters

Name	In	Required	Type	Description
track_id	path	optional	integer	SoundCloud Track id
limit	query	optional	integer	Number of results to return in the collection.

Responses

200

Success

401

Unauthorized

404

Not Found

GET /tracks/{track_id}/reposters

GET /tracks/{track_id}/streams Returns a track's streamable URLs

operationId: Tracks_getStreamableUrls

Parameters

Name	In	Required	Type	Description
track_id	path	optional	integer	SoundCloud Track id
secret_token	query	optional	string	A secret token to fetch private playlists/tracks

Responses

200

Success

401

Unauthorized

404

Not Found

GET /tracks/{track_id}/streams

Users 7 endpoints

GET /users/{user_id} Returns a user.

operationId: Users_getUser

Parameters

Name	In	Required	Type	Description
user_id	path	optional	integer	SoundCloud User id

Responses

200

Success

401

Unauthorized

404

Not Found

GET /users/{user_id}

GET /users/{user_id}/followers Returns a list of user’s followers.

Returns a list of users that follows (user_id).

operationId: Users_getFollowers

Parameters

Name	In	Required	Type	Description
user_id	path	optional	integer	SoundCloud User id
limit	query	optional	integer	Number of results to return in the collection.

Responses

200

Success

401

Unauthorized

GET /users/{user_id}/followers

GET /users/{user_id}/followings Returns a list of user’s followings.

Returns list of users that (user_id) follows.

operationId: Users_getUserFollowings

Parameters

Name	In	Required	Type	Description
user_id	path	optional	integer	SoundCloud User id
limit	query	optional	integer	Number of results to return in the collection.

Responses

200

Success

401

Unauthorized

GET /users/{user_id}/followings

GET /users/{user_id}/likes/playlists Returns a list of user's liked playlists.

operationId: Users_listLikedPlaylists

Parameters

Name	In	Required	Type	Description
user_id	path	optional	integer	SoundCloud User id
limit	query	optional	integer	Number of results to return in the collection.
linked_partitioning	query	optional	boolean	Returns paginated collection of items (recommended, returning a list without pagination is deprecated and should not be used)

Responses

200

Success

400

Bad Request

401

Unauthorized

404

Not Found

GET /users/{user_id}/likes/playlists

GET /users/{user_id}/likes/tracks Returns a list of user's liked tracks.

operationId: Users_listLikedTracks

Parameters

Name	In	Required	Type	Description
user_id	path	optional	integer	SoundCloud User id
access	query	optional	array	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.
limit	query	optional	integer	Number of results to return in the collection.
linked_partitioning	query	optional	boolean	Returns paginated collection of items (recommended, returning a list without pagination is deprecated and should not be used)

Responses

200

Success

400

Bad Request

401

Unauthorized

404

Not Found

GET /users/{user_id}/likes/tracks

GET /users/{user_id}/playlists Returns a list of user's playlists.

operationId: Users_getUserPlaylists

Parameters

Name	In	Required	Type	Description
user_id	path	optional	integer	SoundCloud User id
access	query	optional	array	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.
show_tracks	query	optional	boolean	A boolean flag to request a playlist with or without tracks. Default is `true`.
limit	query	optional	integer	Number of results to return in the collection.
linked_partitioning	query	optional	boolean	Returns paginated collection of items (recommended, returning a list without pagination is deprecated and should not be used)

Responses

200

Success

401

Unauthorized

GET /users/{user_id}/playlists

GET /users/{user_id}/tracks Returns a list of user's tracks.

operationId: Users_getUserTracks

Parameters

Name	In	Required	Type	Description
user_id	path	optional	integer	SoundCloud User id
access	query	optional	array	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.
limit	query	optional	integer	Number of results to return in the collection.
linked_partitioning	query	optional	boolean	Returns paginated collection of items (recommended, returning a list without pagination is deprecated and should not be used)

Responses

200

Success

401

Unauthorized

GET /users/{user_id}/tracks

Load more endpoints

Schemas

object Activities

{
  "type": "object",
  "properties": {
    "next_href": {
      "type": "string"
    },
    "collection": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "description": "Type of activity (track)."
          },
          "origin": {
            "type": "object",
            "anyOf": [
              {
                "$ref": "#/components/schemas/Track"
              },
              {
                "$ref": "#/components/schemas/Playlist"
              }
            ],
            "description": "Origin."
          },
          "created_at": {
            "type": "string",
            "description": "Created timestamp."
          }
        }
      }
    },
    "future_href": {
      "type": "string"
    }
  },
  "description": "User's activities."
}

object Comment

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "Identifier."
    },
    "uri": {
      "type": "string",
      "description": "Comment's URL."
    },
    "body": {
      "type": "string",
      "description": "Comment body."
    },
    "kind": {
      "type": "string",
      "description": "Kind (comment)."
    },
    "user": {
      "type": "object",
      "properties": {
        "id": {
          "type": "integer",
          "description": "unique identifier"
        },
        "uri": {
          "type": "string",
          "description": "API resource URL."
        },
        "kind": {
          "type": "string",
          "description": "kind of resource."
        },
        "username": {
          "type": "string",
          "description": "username"
        },
        "permalink": {
          "type": "string",
          "description": "permalink of the resource."
        },
        "avatar_url": {
          "type": "string",
          "description": "URL to a JPEG image."
        },
        "last_modified": {
          "type": "string",
          "description": "last modified timestamp."
        },
        "permalink_url": {
          "type": "string",
          "description": "URL to the SoundCloud.com page."
        },
        "reposts_count": {
          "type": "integer",
          "description": "number of reposts from user"
        },
        "followers_count": {
          "type": "integer",
          "description": "number of followers."
        },
        "followings_count": {
          "type": "integer",
          "description": "number of followed users."
        }
      },
      "description": "SoundCloud User object"
    },
    "user_id": {
      "type": "integer",
      "description": "User's identifier."
    },
    "track_id": {
      "type": "integer",
      "description": "Track's identifier."
    },
    "timestamp": {
      "type": "string",
      "description": "Timestamp."
    },
    "created_at": {
      "type": "string",
      "description": "Created timestamp."
    }
  },
  "description": "User's Comment"
}

object Comments

{
  "type": "object",
  "properties": {
    "next_href": {
      "type": "string",
      "nullable": true
    },
    "collection": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Comment"
      }
    }
  }
}

object CreateUpdatePlaylistFormRequest

{
  "type": "object",
  "properties": {
    "playlist[ean]": {
      "type": "string"
    },
    "playlist[genre]": {
      "type": "string"
    },
    "playlist[title]": {
      "type": "string"
    },
    "playlist[license]": {
      "type": "string"
    },
    "playlist[release]": {
      "type": "string"
    },
    "playlist[sharing]": {
      "enum": [
        "public",
        "private"
      ],
      "type": "string",
      "default": "public"
    },
    "playlist[set_type]": {
      "enum": [
        "album",
        "playlist"
      ],
      "type": "string"
    },
    "playlist[tag_list]": {
      "type": "string"
    },
    "playlist[permalink]": {
      "type": "string"
    },
    "playlist[label_name]": {
      "type": "string"
    },
    "playlist[description]": {
      "type": "string"
    },
    "playlist[artwork_data]": {
      "type": "string",
      "title": "The playlist artwork in binary format. Supported formats are gif, jpeg and png",
      "format": "binary"
    },
    "playlist[purchase_url]": {
      "type": "string"
    },
    "playlist[release_date]": {
      "type": "string"
    },
    "playlist[tracks][][id]": {
      "type": "string",
      "description": "To pass multiple tracks, pass multiple comma-separated values, e.g. -F \"playlist[tracks][][id]=111,222\""
    },
    "playlist[permalink_url]": {
      "type": "string"
    },
    "playlist[purchase_title]": {
      "type": "string"
    }
  }
}

object CreateUpdatePlaylistRequest

{
  "type": "object",
  "properties": {
    "playlist": {
      "type": "object",
      "properties": {
        "ean": {
          "type": "string",
          "description": "The European Article Number"
        },
        "genre": {
          "type": "string",
          "description": "Playlist's genre"
        },
        "title": {
          "type": "string",
          "description": "Title of the playlist"
        },
        "tracks": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "description": "SoundCloud track id"
              }
            }
          },
          "description": "List of tracks to add to playlist"
        },
        "license": {
          "type": "string",
          "description": "License number"
        },
        "release": {
          "type": "string",
          "description": "Playlist's release"
        },
        "sharing": {
          "enum": [
            "public",
            "private"
          ],
          "type": "string",
          "description": "public or private"
        },
        "set_type": {
          "enum": [
            "album",
            "playlist"
          ],
          "type": "string",
          "description": "Playlist or album type"
        },
        "tag_list": {
          "type": "string",
          "description": "A comma-separated list of tags"
        },
        "permalink": {
          "type": "string",
          "description": "Playlist's permalink"
        },
        "label_name": {
          "type": "string",
          "description": "Label name"
        },
        "description": {
          "type": "string",
          "description": "Description of the playlist"
        },
        "artwork_data": {
          "type": "string",
          "title": "Only for POST",
          "format": "binary"
        },
        "purchase_url": {
          "type": "string",
          "description": "Purchase URL"
        },
        "release_date": {
          "type": "string",
          "description": "Release date"
        },
        "permalink_url": {
          "type": "string",
          "description": "Full permalink URL"
        },
        "purchase_title": {
          "type": "string",
          "description": "Purchase title"
        }
      }
    }
  }
}

object Error

{
  "type": "object",
  "properties": {
    "code": {
      "type": "integer"
    },
    "link": {
      "type": "string"
    },
    "error": {
      "type": "string",
      "nullable": true,
      "deprecated": true
    },
    "errors": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "deprecated": true
    },
    "status": {
      "type": "string",
      "deprecated": true
    },
    "message": {
      "type": "string"
    }
  }
}

object Found

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "description": "Status code."
    },
    "location": {
      "type": "string",
      "description": "Location URL of the resource."
    }
  }
}

object Me

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "unique identifier"
    },
    "uri": {
      "type": "string",
      "description": "API resource URL."
    },
    "city": {
      "type": "string",
      "description": "city."
    },
    "kind": {
      "type": "string",
      "description": "kind of resource."
    },
    "plan": {
      "type": "string",
      "description": "subscription plan of the user."
    },
    "quota": {
      "type": "object",
      "properties": {
        "upload_seconds_left": {
          "type": "integer",
          "nullable": true,
          "description": "upload seconds left."
        },
        "upload_seconds_used": {
          "type": "integer",
          "description": "upload seconds used."
        },
        "unlimited_upload_quota": {
          "type": "boolean",
          "description": "unlimited upload quota."
        }
      },
      "description": "user's upload quota"
    },
    "locale": {
      "type": "string",
      "nullable": true,
      "description": "locale."
    },
    "online": {
      "type": "boolean",
      "description": "online."
    },
    "country": {
      "type": "string",
      "description": "country."
    },
    "website": {
      "type": "string",
      "description": "a URL to the website."
    },
    "username": {
      "type": "string",
      "description": "username"
    },
    "full_name": {
      "type": "string",
      "description": "first and last name."
    },
    "last_name": {
      "type": "string",
      "description": "last name."
    },
    "permalink": {
      "type": "string",
      "description": "permalink of the resource."
    },
    "avatar_url": {
      "type": "string",
      "description": "URL to a JPEG image."
    },
    "created_at": {
      "type": "string",
      "description": "created at date"
    },
    "first_name": {
      "type": "string",
      "description": "first name."
    },
    "description": {
      "type": "string",
      "description": "description."
    },
    "likes_count": {
      "type": "integer",
      "description": "likes count."
    },
    "track_count": {
      "type": "integer",
      "description": "number of public tracks."
    },
    "discogs_name": {
      "type": "string",
      "description": "discogs name."
    },
    "myspace_name": {
      "type": "string",
      "deprecated": true,
      "description": "myspace name"
    },
    "last_modified": {
      "type": "string",
      "description": "last modified timestamp."
    },
    "permalink_url": {
      "type": "string",
      "description": "URL to the SoundCloud.com page."
    },
    "reposts_count": {
      "type": "integer",
      "description": "number of reposts from user"
    },
    "subscriptions": {
      "items": {
        "type": "array",
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "product": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "subscription id instance."
                  },
                  "name": {
                    "type": "string",
                    "description": "subscription name instance."
                  }
                },
                "description": "product"
              },
              "recurring": {
                "type": "boolean",
                "description": "if the subscription is recurring or not"
              }
            },
            "description": "subscription"
          }
        ],
        "items": {
          "description": "WARNING: Missing items property in array schema. Missing items property has been filled with this AnyType schema."
        }
      },
      "description": "a list subscriptions associated with the user"
    },
    "website_title": {
      "type": "string",
      "description": "a custom title for the website."
    },
    "comments_count": {
      "type": "integer",
      "deprecated": true,
      "description": "comments count. From now on, the field always has a `0` value."
    },
    "playlist_count": {
      "type": "integer",
      "description": "number of public playlists."
    },
    "followers_count": {
      "type": "integer",
      "description": "number of followers."
    },
    "followings_count": {
      "type": "integer",
      "description": "number of followed users."
    },
    "upload_seconds_left": {
      "type": "integer",
      "nullable": true,
      "description": "upload seconds left."
    },
    "private_tracks_count": {
      "type": "integer",
      "description": "number of private tracks."
    },
    "public_favorites_count": {
      "type": "integer",
      "description": "number of favorited public tracks"
    },
    "primary_email_confirmed": {
      "type": "boolean",
      "description": "boolean if email is confirmed."
    },
    "private_playlists_count": {
      "type": "integer",
      "description": "number of private playlists."
    }
  },
  "description": "SoundCloud Me object"
}

object MeGetLikedPlaylistsResponse

{
  "oneOf": [
    {
      "$ref": "#/components/schemas/Playlists"
    },
    {
      "$ref": "#/components/schemas/PlaylistsArray"
    }
  ]
}

object MeListLikedTracksResponse

{
  "oneOf": [
    {
      "$ref": "#/components/schemas/Tracks"
    },
    {
      "$ref": "#/components/schemas/TracksList"
    }
  ]
}

object OAuthToken

{
  "type": "object",
  "required": [
    "grant_type",
    "client_id",
    "client_secret"
  ],
  "properties": {
    "code": {
      "type": "string",
      "example": "1-123456-12345678-FAbcfbe9ir2wdj0",
      "description": "Authorization code. Required on `grant_type = authorization_code`."
    },
    "client_id": {
      "type": "string",
      "example": "CLIENT_ID",
      "description": "Client ID"
    },
    "grant_type": {
      "enum": [
        "authorization_code",
        "refresh_token",
        "client_credentials"
      ],
      "type": "string",
      "example": "authorization_code",
      "description": "One of `authorization_code`, `client_credentials`, `refresh_token`"
    },
    "redirect_uri": {
      "type": "string",
      "example": "https://mywebsite/auth/soundcloud",
      "description": "Redirect URI. Required on `grant_type = (authorization_code|refresh_token)`."
    },
    "client_secret": {
      "type": "string",
      "example": "CLIENT_SECRET",
      "description": "Client secret"
    },
    "refresh_token": {
      "type": "string",
      "example": "1234c331329477150e7b6056ff212345",
      "description": "Refresh token. Required on `grant_type = refresh_token`."
    }
  }
}

object OauthProvisionAccessToken401Response

{
  "oneOf": [
    {
      "$ref": "#/components/schemas/Error"
    }
  ]
}

object OauthProvisionAccessTokenResponse

{
  "oneOf": [
    {
      "$ref": "#/components/schemas/Error"
    }
  ]
}

object Playlist

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "Playlist identifier."
    },
    "ean": {
      "type": "string",
      "description": "European Article Number."
    },
    "uri": {
      "type": "string",
      "description": "Playlist URI."
    },
    "kind": {
      "type": "string",
      "description": "Type of Soundcloud object (playlist)."
    },
    "tags": {
      "type": "string",
      "nullable": true,
      "description": "Tags."
    },
    "type": {
      "type": "string",
      "description": "Playlist type."
    },
    "user": {
      "$ref": "#/components/schemas/User"
    },
    "genre": {
      "type": "string",
      "description": "Playlist genre."
    },
    "label": {
      "allOf": [
        {
          "type": "object",
          "nullable": true
        },
        {
          "$ref": "#/components/schemas/User"
        }
      ]
    },
    "title": {
      "type": "string",
      "description": "Playlist title."
    },
    "tracks": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Track"
      },
      "description": "List of tracks."
    },
    "license": {
      "type": "string",
      "description": "License."
    },
    "release": {
      "type": "string",
      "description": "Release."
    },
    "sharing": {
      "type": "string",
      "description": "Type of sharing (private/public)."
    },
    "user_id": {
      "type": "integer",
      "description": "User identifier."
    },
    "duration": {
      "type": "integer",
      "description": "Playlist duration."
    },
    "label_id": {
      "type": "integer",
      "description": "Label user identifier."
    },
    "tag_list": {
      "type": "string",
      "description": "Tags."
    },
    "permalink": {
      "type": "string",
      "description": "Playlist permalink."
    },
    "created_at": {
      "type": "string",
      "description": "Created timestamp."
    },
    "label_name": {
      "type": "string",
      "description": "Label name."
    },
    "streamable": {
      "type": "boolean",
      "description": "Is streamable."
    },
    "tracks_uri": {
      "type": "string",
      "nullable": true,
      "description": "tracks URI."
    },
    "artwork_url": {
      "type": "string",
      "description": "URL to a JPEG image."
    },
    "description": {
      "type": "string",
      "description": "Playlist description."
    },
    "likes_count": {
      "type": "integer",
      "description": "Count of playlist likes."
    },
    "release_day": {
      "type": "integer",
      "description": "Day of release."
    },
    "track_count": {
      "type": "integer",
      "description": "Count of tracks."
    },
    "downloadable": {
      "type": "boolean",
      "description": "is downloadable."
    },
    "purchase_url": {
      "type": "string",
      "description": "Purchase URL."
    },
    "release_year": {
      "type": "integer",
      "description": "Year of release."
    },
    "embeddable_by": {
      "type": "string",
      "description": "Embeddable by."
    },
    "last_modified": {
      "type": "string",
      "description": "Last modified timestamp."
    },
    "permalink_url": {
      "type": "string",
      "description": "Playlist permalink URL."
    },
    "playlist_type": {
      "type": "string",
      "description": "Type of playlist."
    },
    "release_month": {
      "type": "integer",
      "description": "Month of release."
    },
    "purchase_title": {
      "type": "string",
      "description": "Purchase title."
    }
  },
  "description": "Soundcloud Playlist Object"
}

object Playlists

{
  "type": "object",
  "properties": {
    "next_href": {
      "type": "string"
    },
    "collection": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Playlist"
      }
    }
  }
}

array PlaylistsArray

{
  "type": "array",
  "items": {
    "$ref": "#/components/schemas/Playlist"
  },
  "deprecated": true
}

object PlaylistsCreateNewPlaylistRequest

{
  "allOf": [
    {
      "$ref": "#/components/schemas/CreateUpdatePlaylistFormRequest"
    },
    {
      "required": [
        "playlist[title]"
      ]
    }
  ]
}

object Streams

{
  "type": "object",
  "properties": {
    "hls_mp3_128_url": {
      "type": "string"
    },
    "hls_opus_64_url": {
      "type": "string"
    },
    "http_mp3_128_url": {
      "type": "string"
    },
    "preview_mp3_128_url": {
      "type": "string"
    }
  }
}

object TooManyRequests

{
  "allOf": [
    {
      "$ref": "#/components/schemas/Error"
    },
    {
      "type": "object",
      "properties": {
        "spam_warning_urn": {
          "type": "string"
        }
      }
    }
  ]
}

object Track

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "Track identifier."
    },
    "bpm": {
      "type": "integer",
      "description": "Tempo."
    },
    "uri": {
      "type": "string",
      "description": "Track URI."
    },
    "isrc": {
      "type": "string",
      "description": "ISRC code."
    },
    "kind": {
      "type": "string",
      "description": "Type of object (track)."
    },
    "user": {
      "allOf": [
        {
          "$ref": "#/components/schemas/User"
        },
        {
          "description": "User who uploaded a track"
        }
      ]
    },
    "genre": {
      "type": "string",
      "description": "Genre"
    },
    "title": {
      "type": "string",
      "description": "Track title."
    },
    "access": {
      "enum": [
        "playable",
        "preview",
        "blocked"
      ],
      "type": "string",
      "nullable": true,
      "description": "Level of access the user (logged in or anonymous) has to the track.\n  * `playable` - user is allowed to listen to a full track.\n  * `preview` - user is allowed to preview a track, meaning a snippet is available\n  * `blocked` - user can only see the metadata of a track, no streaming is possible\n"
    },
    "license": {
      "type": "string",
      "description": "License"
    },
    "release": {
      "type": "string",
      "description": "Release."
    },
    "sharing": {
      "type": "string",
      "description": "Type of sharing (public/private)."
    },
    "duration": {
      "type": "integer",
      "description": "Track duration."
    },
    "tag_list": {
      "type": "string",
      "description": "Tags."
    },
    "created_at": {
      "type": "string",
      "description": "Created timestamp."
    },
    "label_name": {
      "type": "string",
      "description": "Label user name."
    },
    "secret_uri": {
      "type": "string",
      "description": "Secret URL."
    },
    "stream_url": {
      "type": "string",
      "description": "URL to stream."
    },
    "streamable": {
      "type": "boolean",
      "description": "Is streamable."
    },
    "artwork_url": {
      "type": "string",
      "description": "URL to a JPEG image."
    },
    "commentable": {
      "type": "boolean",
      "description": "Is commentable."
    },
    "description": {
      "type": "string",
      "description": "Track description."
    },
    "release_day": {
      "type": "integer",
      "description": "Day of release."
    },
    "download_url": {
      "type": "string",
      "description": "URL to download a track."
    },
    "downloadable": {
      "type": "string",
      "description": "Is downloadable."
    },
    "purchase_url": {
      "type": "string",
      "description": "Purchase URL."
    },
    "release_year": {
      "type": "integer",
      "description": "Year of release."
    },
    "waveform_url": {
      "type": "string",
      "description": "Waveform URL."
    },
    "comment_count": {
      "type": "integer",
      "description": "Number of comments."
    },
    "embeddable_by": {
      "type": "string",
      "deprecated": true,
      "description": "Embeddable by."
    },
    "key_signature": {
      "type": "string",
      "description": "Key signature."
    },
    "permalink_url": {
      "type": "string",
      "description": "Permalink URL."
    },
    "release_month": {
      "type": "integer",
      "description": "Month of release."
    },
    "reposts_count": {
      "type": "integer",
      "description": "Number of reposts."
    },
    "user_favorite": {
      "type": "boolean",
      "description": "Is user's favourite."
    },
    "download_count": {
      "type": "integer",
      "description": "NUmber of downloads."
    },
    "playback_count": {
      "type": "integer",
      "description": "Number of plays."
    },
    "purchase_title": {
      "type": "string",
      "description": "Purchase title."
    },
    "favoritings_count": {
      "type": "integer",
      "description": "Number of favoritings."
    },
    "user_playback_count": {
      "type": "integer",
      "description": "Number of plays by a user."
    },
    "available_country_codes": {
      "type": "string",
      "description": "List of countries where track is available."
    }
  },
  "description": "Soundcloud Track object."
}

object TrackDataRequest

{
  "type": "object",
  "properties": {
    "track[isrc]": {
      "type": "string"
    },
    "track[genre]": {
      "type": "string"
    },
    "track[title]": {
      "type": "string"
    },
    "track[license]": {
      "enum": [
        "no-rights-reserved",
        "all-rights-reserved",
        "cc-by",
        "cc-by-nc",
        "cc-by-nd",
        "cc-by-sa",
        "cc-by-nc-nd",
        "cc-by-nc-sa"
      ],
      "type": "string",
      "description": "Possible values: no-rights-reserved, all-rights-reserved, cc-by, cc-by-nc, cc-by-nd, cc-by-sa, cc-by-nc-nd, cc-by-nc-sa"
    },
    "track[release]": {
      "type": "string"
    },
    "track[sharing]": {
      "enum": [
        "public",
        "private"
      ],
      "type": "string",
      "default": "public"
    },
    "track[tag_list]": {
      "type": "string",
      "description": "The tag_list property contains a list of tags separated by spaces. Multiword tags are quoted in double quotes. We also support machine tags that follow the pattern NAMESPACE:KEY=VALUE. For example: geo:lat=43.555 camel:size=medium “machine:tag=with space” Machine tags are not revealed to the user on the track pages."
    },
    "track[permalink]": {
      "type": "string"
    },
    "track[asset_data]": {
      "type": "string",
      "title": "Only for uploading",
      "format": "binary"
    },
    "track[label_name]": {
      "type": "string"
    },
    "track[streamable]": {
      "type": "boolean",
      "default": true
    },
    "track[commentable]": {
      "type": "boolean",
      "default": true
    },
    "track[description]": {
      "type": "string"
    },
    "track[artwork_data]": {
      "type": "string",
      "title": "Only for uploading, for PRO users",
      "format": "binary"
    },
    "track[downloadable]": {
      "type": "boolean",
      "default": true
    },
    "track[purchase_url]": {
      "type": "string"
    },
    "track[release_date]": {
      "type": "string",
      "title": "write only!",
      "description": "string, formatted as yyyy-mm-dd, representing release date"
    },
    "track[embeddable_by]": {
      "enum": [
        "all",
        "me",
        "none"
      ],
      "type": "string",
      "description": "who can embed this track \"all\", \"me\", or \"none\""
    }
  }
}

object TrackMetadataRequest

{
  "type": "object",
  "properties": {
    "track": {
      "type": "object",
      "properties": {
        "isrc": {
          "type": "string"
        },
        "genre": {
          "type": "string"
        },
        "title": {
          "type": "string"
        },
        "license": {
          "enum": [
            "no-rights-reserved",
            "all-rights-reserved",
            "cc-by",
            "cc-by-nc",
            "cc-by-nd",
            "cc-by-sa",
            "cc-by-nc-nd",
            "cc-by-nc-sa"
          ],
          "type": "string",
          "description": "Possible values: no-rights-reserved, all-rights-reserved, cc-by, cc-by-nc, cc-by-nd, cc-by-sa, cc-by-nc-nd, cc-by-nc-sa"
        },
        "release": {
          "type": "string"
        },
        "sharing": {
          "enum": [
            "public",
            "private"
          ],
          "type": "string",
          "default": "public"
        },
        "tag_list": {
          "type": "string",
          "description": "The tag_list property contains a list of tags separated by spaces. Multiword tags are quoted in double quotes. We also support machine tags that follow the pattern NAMESPACE:KEY=VALUE. For example: geo:lat=43.555 camel:size=medium “machine:tag=with space” Machine tags are not revealed to the user on the track pages."
        },
        "permalink": {
          "type": "string"
        },
        "label_name": {
          "type": "string"
        },
        "streamable": {
          "type": "boolean",
          "default": true
        },
        "commentable": {
          "type": "boolean",
          "default": true
        },
        "description": {
          "type": "string"
        },
        "downloadable": {
          "type": "boolean",
          "default": true
        },
        "purchase_url": {
          "type": "string"
        },
        "release_date": {
          "type": "string",
          "title": "write only!",
          "description": "string, formatted as yyyy-mm-dd, representing release date"
        },
        "embeddable_by": {
          "enum": [
            "all",
            "me",
            "none"
          ],
          "type": "string",
          "description": "who can embed this track \"all\", \"me\", or \"none\""
        }
      }
    }
  }
}

object Tracks

{
  "type": "object",
  "properties": {
    "next_href": {
      "type": "string"
    },
    "collection": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Track"
      }
    }
  }
}

object TracksCreateCommentRequest

{
  "type": "object",
  "properties": {
    "comment": {
      "type": "object",
      "required": [
        "body"
      ],
      "properties": {
        "body": {
          "type": "string",
          "example": "test comment",
          "description": "Comment's content"
        },
        "timestamp": {
          "oneOf": [
            {
              "type": "string"
            },
            {
              "type": "number"
            }
          ],
          "description": "Timestamp of a comment. String or float representation is supported"
        }
      }
    }
  }
}

array TracksList

{
  "type": "array",
  "items": {
    "$ref": "#/components/schemas/Track"
  },
  "deprecated": true
}

object TracksUploadNewTrackRequest

{
  "allOf": [
    {
      "$ref": "#/components/schemas/TrackDataRequest"
    },
    {
      "required": [
        "track[title]",
        "track[asset_data]"
      ]
    }
  ]
}

object TracksUploadNewTrackRequest1

{
  "allOf": [
    {
      "$ref": "#/components/schemas/TrackDataRequest"
    },
    {
      "required": [
        "track[title]",
        "track[asset_data]"
      ]
    }
  ]
}

object User

{
  "type": "object",
  "nullable": true,
  "properties": {
    "id": {
      "type": "integer",
      "description": "unique identifier"
    },
    "uri": {
      "type": "string",
      "description": "API resource URL"
    },
    "city": {
      "type": "string",
      "description": "city"
    },
    "kind": {
      "type": "string",
      "description": "kind of resource"
    },
    "plan": {
      "type": "string",
      "description": "subscription plan of the user"
    },
    "country": {
      "type": "string",
      "description": "country"
    },
    "website": {
      "type": "string",
      "description": "a URL to the website"
    },
    "username": {
      "type": "string",
      "description": "username"
    },
    "full_name": {
      "type": "string",
      "description": "first and last name"
    },
    "last_name": {
      "type": "string",
      "description": "last name"
    },
    "permalink": {
      "type": "string",
      "description": "permalink of the resource"
    },
    "avatar_url": {
      "type": "string",
      "description": "URL to a JPEG image"
    },
    "created_at": {
      "type": "string",
      "format": "date-time",
      "description": "profile creation datetime"
    },
    "first_name": {
      "type": "string",
      "description": "first name"
    },
    "description": {
      "type": "string",
      "description": "description"
    },
    "track_count": {
      "type": "integer",
      "description": "number of public tracks"
    },
    "discogs_name": {
      "type": "string",
      "description": "discogs name"
    },
    "myspace_name": {
      "type": "string",
      "deprecated": true,
      "description": "myspace name"
    },
    "last_modified": {
      "type": "string",
      "format": "date-time",
      "description": "last modified datetime"
    },
    "permalink_url": {
      "type": "string",
      "description": "URL to the SoundCloud.com page"
    },
    "reposts_count": {
      "type": "integer",
      "description": "number of reposts from user"
    },
    "subscriptions": {
      "items": {
        "type": "array",
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "product": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "subscription id instance."
                  },
                  "name": {
                    "type": "string",
                    "description": "subscription name instance."
                  }
                },
                "description": "product"
              },
              "recurring": {
                "type": "boolean",
                "description": "if the subscription is recurring or not"
              }
            },
            "description": "subscription"
          }
        ],
        "items": {
          "description": "WARNING: Missing items property in array schema. Missing items property has been filled with this AnyType schema."
        }
      },
      "deprecated": true,
      "description": "a list subscriptions associated with the user"
    },
    "website_title": {
      "type": "string",
      "description": "a custom title for the website"
    },
    "playlist_count": {
      "type": "integer",
      "description": "number of public playlists"
    },
    "followers_count": {
      "type": "integer",
      "description": "number of followers"
    },
    "followings_count": {
      "type": "integer",
      "description": "number of followed users"
    },
    "public_favorites_count": {
      "type": "integer",
      "description": "number of favorited public tracks"
    }
  },
  "description": "SoundCloud User object"
}

object Users

{
  "type": "object",
  "properties": {
    "next_href": {
      "type": "string"
    },
    "collection": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/User"
      }
    }
  }
}

array WebProfiles

{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "id": {
        "type": "integer",
        "description": "Id"
      },
      "url": {
        "type": "string",
        "description": "URL of the external link"
      },
      "kind": {
        "type": "string",
        "description": "Kind"
      },
      "title": {
        "type": "string",
        "description": "Link's title"
      },
      "service": {
        "type": "string",
        "description": "Service or platform"
      },
      "username": {
        "type": "string",
        "description": "Username extracted from the external link"
      },
      "created_at": {
        "type": "string",
        "description": "Timestamp of when the link was added to the profile."
      }
    }
  },
  "description": "User's links added to their profile"
}

Versions

Version	Endpoints	Schemas	Ingested	Status
1.0.0	55	30	2026-05-11	current
1.0.0	55	30	2026-04-16