SoundCloud Public API Specification
SoundCloud Public API Specification endpoints from SoundCloud
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
SoundCloud Public API Specification endpoints from SoundCloud
Endpoints 59
oauth
- GETThe OAuth2 authorization endpoint. Your app redirects a user to this endpoint, allowing them to delegate access to their account.
/connect?client_id=some client&redirect_uri=https://soundcloud.com&response_type=code&scope=default&state=encrypted_session_info<h3>Security Advice</h3> * Using the implicit OAuth authorization flow (response_type=token) is not recommended. It can suffer from access token leakage and… - POSTThis endpoint accepts POST requests and is used to provision access tokens once a user has authorized your application.
/oauth2/token
me
- GETReturns the authenticated user’s information.
/me - GETReturns the authenticated user's activities.
/me/activities?access=playable,preview&limit=2 - GETRecent the authenticated user's activities.
/me/activities/all/own?access=playable,preview&limit=2 - GETReturns the authenticated user's recent track related activities.
/me/activities/tracks?access=playable,preview&limit=2 - GETReturns a list of the authenticated user's connected social accounts.
/me/connections?limit=2&offset=0 - GETReturns the authenticated user's connected social account.
/me/connections/:connection_id - GETReturns user’s favorites ids. (use /me/likes/tracks instead to fetch the authenticated user's likes)
/me/favorites/ids?limit=2Deprecated. - GETReturns a list of users who are following the authenticated user.
/me/followers?limit=2 - GETReturns a user who is following the authenticated user. (use /users/{user_id} instead, to fetch the user details)
/me/followers/:follower_idDeprecated. - GETReturns a list of users who are followed by the authenticated user.
/me/followings?limit=2&offset=0 - GETReturns a list of recent tracks from users followed by the authenticated user.
/me/followings/tracks?access=playable,preview&limit=2&offset=0 - GETReturns a user who is followed by the authenticated user. (use /users/{user_id} instead, to fetch the user details)
/me/followings/:user_idDeprecated. - PUTFollows a user.
/me/followings/:user_id - DELETEDeletes a user who is followed by the authenticated user.
/me/followings/:user_id - GETReturns a list of favorited or liked tracks of the authenticated user.
/me/likes/tracks?limit=2&linked_partitioning=true - GETReturns user’s playlists (sets).
/me/playlists?limit=2Returns playlist info, playlist tracks and tracks owner info. - GETReturns playlist. (use /playlists/{playlist_id} instead, to fetch the playlist details)
/me/playlists/:playlist_idDeprecated. - GETReturns a list of user's tracks.
/me/tracks?limit=2&linked_partitioning=true - GETReturns a specified track. (use /tracks/{track_id} instead, to fetch the track details)
/me/tracks/:track_idDeprecated.
search
- GETPerforms a playlist search based on a query
/playlists?q=hello&access=playable,preview&limit=2&offset=0&linked_partitioning=true - GETPerforms a track search based on a query
/tracks?q=hello&ids=1,2,3&genres=Pop,House&tags=test&bpm={"from":123,"to":456}&duration={"from":123456,"to":456789}&created_at={"from":"2020-12-24T00:00:00.000Z","to":"2020-12-26T00:00:00.000Z"}&access=playable,preview&limit=2&offset=0&linked_partitioning=true - GETPerforms a user search based on a query
/users?q=hello&ids=1,2,3&limit=2&offset=0&linked_partitioning=true
playlists
- POSTCreates a playlist.
/playlists - GETReturns a playlist.
/playlists/:playlist_id?secret_token=string&access=playable,preview - PUTUpdates a playlist.
/playlists/:playlist_id - DELETEDeletes a playlist.
/playlists/:playlist_id - GETReturns a collection of playlist's reposters.
/playlists/:playlist_id/reposters?limit=2 - GETReturns tracks under a playlist.
/playlists/:playlist_id/tracks?secret_token=string&access=playable,preview&linked_partitioning=true
tracks
- POSTUploads a new track.
/tracks - GETReturns a track.
/tracks/:track_id?secret_token=string - PUTUpdates a track's information.
/tracks/:track_id - DELETEDeletes a track.
/tracks/:track_id - GETReturns the comments posted on the track(track_id).
/tracks/:track_id/comments?limit=2&offset=0&linked_partitioning=true - POSTReturns the newly created comment on success
/tracks/:track_id/comments - GETReturns a list of users who have favorited or liked the track.
/tracks/:track_id/favoriters?limit=2&offset=0 - GETReturns all related tracks of track on SoundCloud.
/tracks/:track_id/related?access=playable,preview&limit=2&offset=0&linked_partitioning=true - GETReturns a collection of track's reposters.
/tracks/:track_id/reposters?limit=2 - GETReturns a track's streamable URLs
/tracks/:track_id/streams?secret_token=string
users
- GETReturns a user.
/users/:user_id - GETReturns a list of user's comments.
/users/:user_id/comments?limit=2&offset=0 - GETReturns a list of user's favorited or liked tracks. (use /users/:userId/likes/tracks instead, to fetch a user's likes)
/users/:user_id/favorites?limit=2&linked_partitioning=trueDeprecated. - GETReturns a list of user’s followers.
/users/:user_id/followers?limit=2Returns a list of users that follows (user_id). - GETReturns a list of user’s followings.
/users/:user_id/followings?limit=2Returns list of users that (user_id) follows. - GETReturns a user's following. (use /users/{user_id} instead, to fetch the user details)
/users/:user_id/followings/:following_idDeprecated. Returns (following_id) that is followed by (user_id). - GETReturns a list of user's liked tracks.
/users/:user_id/likes/tracks?access=playable,preview&limit=2&linked_partitioning=true - GETReturns a list of user's playlists.
/users/:user_id/playlists?access=playable,preview&limit=2&linked_partitioning=true - GETReturns a list of user's tracks.
/users/:user_id/tracks?access=playable,preview&limit=2&linked_partitioning=true - GETReturns list of user's links added to their profile (website, facebook, instagram).
/users/:user_id/web-profiles?limit=2
likes
- POSTLikes a playlist.
/likes/playlists/:playlist_id - DELETEUnlikes a playlist.
/likes/playlists/:playlist_id - POSTLikes a track.
/likes/tracks/:track_id - DELETEUnlikes a track.
/likes/tracks/:track_id
reposts
- POSTReposts a playlist as the authenticated user
/reposts/playlists/:playlist_id - DELETERemoves a repost on a playlist as the authenticated user
/reposts/playlists/:playlist_id - POSTReposts a track as the authenticated user
/reposts/tracks/:track_id - DELETERemoves a repost on a track as the authenticated user
/reposts/tracks/:track_id
miscellaneous
- GETResolves soundcloud.com URLs to Resource URLs to use with the API.
/resolve?url=https://soundcloud.com/user-434241656
API details
- Base URL
https://api.soundcloud.com- Authentication
- An API key in the Authorization header
An API key in the client_id query parameter - Operations
- 59 operations on 46 pathsGET 41POST 8DELETE 7PUT 3
7 marked deprecated - Main resources
- me 19tracks 10users 10playlists 6likes 4reposts 4search 3oauth 2miscellaneous 1
- Response formats
application/json; charset=utf-8application/json- Description format
- OpenAPI 3.0.1, API version
1.0.0 - Links
- OpenAPI document · Terms of service · Support
- Listed from
- APIs.guru OpenAPI Directory (CC0-1.0)
Source updated
How to test the SoundCloud Public API Specification in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the SoundCloud Public API Specification collection, without the publisher's secrets.
- Add your credentialsThis API uses an API key in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “The OAuth2 authorization endpoint. Your app redirects a user to this endpoint, allowing them to delegate access to their account.” (GET /connect?client_id=some client&redirect_uri=https://soundcloud.com&response_type=code&scope=default&state=encrypted_session_info), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the SoundCloud Public API Specification?
SoundCloud Public API Specification endpoints from SoundCloud It is listed under Media & content and has 59 endpoints.
Who publishes the SoundCloud Public API Specification?
It is listed from SoundCloud's public API description (an OpenAPI document), not published by SoundCloud on Swastik Codes. Anyone who controls soundcloud.com can claim the profile by adding a DNS TXT record.
What is the base URL of the SoundCloud Public API Specification?
Requests go to https://api.soundcloud.com. Endpoint paths are added to this base URL.
How do I authenticate with the SoundCloud Public API Specification?
It accepts 2 methods: an API key in the Authorization header; an API key in the client_id query parameter.
How many endpoints does the SoundCloud Public API Specification have?
59 operations on 46 paths (41 GET, 8 POST, 7 DELETE, 3 PUT). The largest groups are me, tracks, users, playlists.
Is forking the SoundCloud Public API Specification free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.