SoundCloud Public API Specification
  1. oauth
SoundCloud Public API Specification
  • oauth
    • The OAuth2 authorization endpoint. Your app redirects a user to this endpoint, allowing them to delegate access to their account.
      GET
    • This endpoint accepts POST requests and is used to provision access tokens once a user has authorized your application.
      POST
  • likes
    • Unlikes a playlist.
      DELETE
    • Likes a playlist.
      POST
    • Unlikes a track.
      DELETE
    • Likes a track.
      POST
  • me
    • Returns the authenticated user’s information.
      GET
    • Returns the authenticated user's activities.
      GET
    • Recent the authenticated user's activities.
      GET
    • Returns the authenticated user's recent track related activities.
      GET
    • Returns a list of the authenticated user's connected social accounts.
      GET
    • Returns the authenticated user's connected social account.
      GET
    • Returns user’s favorites ids. (use /me/likes/tracks instead to fetch the authenticated user's likes)
      GET
    • Returns a list of users who are following the authenticated user.
      GET
    • Returns a user who is following the authenticated user. (use /users/{user_id} instead, to fetch the user details)
      GET
    • Returns a list of users who are followed by the authenticated user.
      GET
    • Returns a list of recent tracks from users followed by the authenticated user.
      GET
    • Deletes a user who is followed by the authenticated user.
      DELETE
    • Returns a user who is followed by the authenticated user. (use /users/{user_id} instead, to fetch the user details)
      GET
    • Follows a user.
      PUT
    • Returns a list of favorited or liked tracks of the authenticated user.
      GET
    • Returns user’s playlists (sets).
      GET
    • Returns playlist. (use /playlists/{playlist_id} instead, to fetch the playlist details)
      GET
    • Returns a list of user's tracks.
      GET
    • Returns a specified track. (use /tracks/{track_id} instead, to fetch the track details)
      GET
  • search
    • Performs a playlist search based on a query
      GET
    • Performs a track search based on a query
      GET
    • Performs a user search based on a query
      GET
  • playlists
    • Creates a playlist.
    • Deletes a playlist.
    • Returns a playlist.
    • Updates a playlist.
    • Returns a collection of playlist's reposters.
    • Returns tracks under a playlist.
  • reposts
    • Removes a repost on a playlist as the authenticated user
    • Reposts a playlist as the authenticated user
    • Removes a repost on a track as the authenticated user
    • Reposts a track as the authenticated user
  • miscellaneous
    • Resolves soundcloud.com URLs to Resource URLs to use with the API.
  • tracks
    • Uploads a new track.
    • Deletes a track.
    • Returns a track.
    • Updates a track's information.
    • Returns the comments posted on the track(track_id).
    • Returns the newly created comment on success
    • Returns a list of users who have favorited or liked the track.
    • Returns all related tracks of track on SoundCloud.
    • Returns a collection of track's reposters.
    • Returns a track's streamable URLs
  • users
    • Returns a user.
    • Returns a list of user's comments.
    • Returns a list of user's favorited or liked tracks. (use /users/:userId/likes/tracks instead, to fetch a user's likes)
    • Returns a list of user’s followers.
    • Returns a list of user’s followings.
    • Returns a user's following. (use /users/{user_id} instead, to fetch the user details)
    • Returns a list of user's liked tracks.
    • Returns a list of user's playlists.
    • Returns a list of user's tracks.
    • Returns list of user's links added to their profile (website, facebook, instagram).
  1. oauth

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

GET
/connect

Security Advice#

Using the implicit OAuth authorization flow (response_type=token) is not recommended. It can suffer from access token leakage and access token replay attacks. Use response_type=code instead.
Use the state parameter for CSRF protection. Pass a sufficient random nonce here and verify this nonce again after retrieving the token.

Request

Query Params

Responses

🔵302302
application/json
Body

🟠401401
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.soundcloud.com/connect?client_id=some client&redirect_uri=https://soundcloud.com&response_type=code&scope=default'
Response Response Example
302 - Example 1
{}
Modified at 2023-08-16 10:15:55
Next
This endpoint accepts POST requests and is used to provision access tokens once a user has authorized your application.
Built with