SoundCloud

SoundCloud Public API Specification

SoundCloud Public API Specification endpoints from SoundCloud

Media & content#openapi#media

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-8 application/json
Description format
OpenAPI 3.0.1, API version 1.0.0
Listed from
APIs.guru OpenAPI Directory (CC0-1.0)
Source updated

How to test the SoundCloud Public API Specification in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the SoundCloud Public API Specification collection, without the publisher's secrets.
  3. 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.
  4. 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.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.