--- canonical_url: "https://docs.composio.dev/toolkits/soundcloud" markdown_url: "https://docs.composio.dev/toolkits/soundcloud.md" product: "platform" version: null last_updated: null --- # SoundCloud SoundCloud API provides access to a wide range of SoundCloud features for playing, uploading, and managing sounds. - **Category:** video & audio - **Auth:** OAUTH2 - **Composio-managed OAuth available?** No - **Tools:** 52 - **Triggers:** 0 - **Slug:** `SOUNDCLOUD` - **Version:** 00000000_00 ## Tools ### Creates a playlist **Slug:** `SOUNDCLOUD_CREATES_A_PLAYLIST` The `/playlists` POST endpoint on SoundCloud allows for playlist creation with title, description, mode, and tracks in a JSON body, requiring AuthHeader. It returns a 201 and playlist details on success, with 401 and 404 codes for errors. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `playlist__ean` | string | No | The European Article Number | | `playlist__genre` | string | No | Playlist"s genre | | `playlist__title` | string | No | Title of the playlist | | `playlist__tracks` | array | No | List of tracks to add to playlist | | `playlist__license` | string | No | License number | | `playlist__release` | string | No | Playlist"s release | | `playlist__sharing` | string ("public" | "private") | No | public or private | | `playlist__permalink` | string | No | Playlist"s permalink | | `playlist__set__type` | string ("album" | "playlist") | No | Playlist or album type | | `playlist__tag__list` | string | No | A comma-separated list of tags | | `playlist__description` | string | No | Description of the playlist | | `playlist__label__name` | string | No | Label name | | `playlist__artwork__data` | string | No | Artwork Data | | `playlist__purchase__url` | string | No | Purchase URL | | `playlist__release__date` | string | No | Release date | | `playlist__permalink__url` | string | No | Full permalink URL | | `playlist__purchase__title` | string | No | Purchase title | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Deletes a playlist **Slug:** `SOUNDCLOUD_DELETES_A_PLAYLIST` Deletes a SoundCloud playlist by its ID, requiring authorization. Success returns 200, while 404 indicates not found, with detailed error messages when available. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `playlist_id` | integer | Yes | SoundCloud playlist id | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Deletes a track **Slug:** `SOUNDCLOUD_DELETES_A_TRACK` This endpoint allows deleting a specific SoundCloud track by its ID. Requires security authentication. Possible responses include 'Success' or 'Not Found' with an optional error message. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `track_id` | integer | Yes | SoundCloud Track id | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Fetch soundcloud follower profile details **Slug:** `SOUNDCLOUD_FETCH_SOUND_CLOUD_FOLLOWER_PROFILE_DETAILS` Fetches SoundCloud user profile details (username, followers) for a user followed by an authenticated user. Use '/users/{user_id}' for full info. Requires AuthHeader. Responses: 200 (Success), 403 (Unauthorized), 404 (Not Found). #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `user_id` | integer | Yes | SoundCloud User id | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Fetchuserfavorites **Slug:** `SOUNDCLOUD_FETCH_USER_FAVORITES` The `/me/likes/playlists` endpoint lets authenticated users access their favorite playlists, supports pagination, and requires an AuthHeader. It delivers detailed playlist, user, and track info. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Number of results to return in the collection. | | `linked_partitioning` | boolean | No | Returns paginated collection of items (recommended, returning a list without pagination is deprecated and should not be used) | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Fetchuserfollowingdetails **Slug:** `SOUNDCLOUD_FETCH_USER_FOLLOWING_DETAILS` Returns (following_id) that is followed by (user_id). #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `user_id` | integer | Yes | SoundCloud User id | | `following_id` | integer | Yes | SoundCloud User id to denote a Following of a user | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Fetchuserprofileslinks **Slug:** `SOUNDCLOUD_FETCH_USER_PROFILES_LINKS` Access a user's profile links (website, Facebook, Instagram) on SoundCloud by user ID. Supports query parameter for result limits. Requires AuthHeader for access. Responds with user link details in JSON format. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Number of results to return in the collection. | | `user_id` | integer | Yes | SoundCloud User id | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Follows a user **Slug:** `SOUNDCLOUD_FOLLOWS_A_USER` The `/me/followings/{user_id}` endpoint on SoundCloud is for following users by ID, secured with `AuthHeader`. It confirms follows or shows user data, returning `200` for success, and `401` or `404` for errors. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `user_id` | integer | Yes | SoundCloud User id | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Getfolloweruserdetails **Slug:** `SOUNDCLOUD_GET_FOLLOWER_USER_DETAILS` Retrieve a SoundCloud user's follower details by ID with AuthHeader. Includes username, country, and followers count. Full details at /users/{user_id}. Note: This endpoint is deprecated. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `follower_id` | integer | Yes | SoundCloud User id to denote a Follower | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Returns all related tracks of track on SoundCloud **Slug:** `SOUNDCLOUD_GET_RELATED_TRACKS` Returns all related tracks of track on SoundCloud #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Number of results to return in the collection. | | `access` | array | No | 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. | | `offset` | integer | No | Offset of first result. Deprecated, use `linked_partitioning` instead. | | `track_id` | integer | Yes | SoundCloud Track id | | `linked_partitioning` | boolean | No | Returns paginated collection of items (recommended, returning a list without pagination is deprecated and should not be used) | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Returns a list of users who have favorited or liked the track **Slug:** `SOUNDCLOUD_GET_TRACK_LIKERS` Returns a list of users who have favorited or liked the track #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Number of results to return in the collection. | | `track_id` | integer | Yes | SoundCloud Track id | | `linked_partitioning` | boolean | No | Returns paginated collection of items (recommended, returning a list without pagination is deprecated and should not be used) | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Likes a playlist **Slug:** `SOUNDCLOUD_LIKES_A_PLAYLIST` This API endpoint lets users like a SoundCloud playlist via POST, needing an AuthHeader and playlist ID. It returns status 200 for success, or 400, 401, 404, 429 errors with explanations. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `playlist_id` | integer | Yes | SoundCloud playlist id | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Likes a track **Slug:** `SOUNDCLOUD_LIKES_A_TRACK` This endpoint enables users to like a track using POST, requiring AuthHeader and track_id. It returns various responses (200, 400, 401, 404, 429) alongside JSON error messages and documentation links. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `track_id` | integer | Yes | SoundCloud Track id | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Listauthenticateduserfollowers **Slug:** `SOUNDCLOUD_LIST_AUTHENTICATED_USER_FOLLOWERS` Fetches the list of followers for the authenticated user with options to limit results. Provides user details including follower count, city, and more. Requires authentication. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Number of results to return in the collection. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Listfollowedbyuser **Slug:** `SOUNDCLOUD_LIST_FOLLOWED_BY_USER` Returns a list of SoundCloud users followed by the authenticated user, with options for result limit and pagination. Supports query parameters for result customization. Requires authentication. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Number of results to return in the collection. | | `offset` | integer | No | Offset of first result. Deprecated, use `linked_partitioning` instead. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Listuserfavorites **Slug:** `SOUNDCLOUD_LIST_USER_FAVORITES` This endpoint fetches a user's favored tracks with options for filtering and pagination. Parameters: `limit` (default 50, max 200), `access` (types), and `linked_partitioning`. `AuthHeader` is needed for security. Returns track details and likes status. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Number of results to return in the collection. | | `access` | array | No | 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` | boolean | No | Returns paginated collection of items (recommended, returning a list without pagination is deprecated and should not be used) | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Oauth2 authorization redirect handler **Slug:** `SOUNDCLOUD_OAUTH2_AUTHORIZATION_REDIRECT_HANDLER` OAuth Authorization Code flow is mandated for authorization, utilizing `response_type=code`. Implement the `state` parameter with a random nonce for CSRF protection, verifying it upon token retrieval. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `state` | string | No | Any value included here will be appended to the redirect URI. Use this for CSRF protection. | | `client_id` | string | Yes | The client id belonging to your application | | `redirect_uri` | string | Yes | The redirect uri you have configured for your application | | `response_type` | string ("code") | Yes | Support only the Authorization Code Flow | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Performs a playlist search based on a query **Slug:** `SOUNDCLOUD_PERFORMS_A_PLAYLIST_SEARCH_BASED_ON_A_QUERY` This endpoint enables playlist searches on Soundcloud using filters such as query, access level, and more. It requires AuthHeader, allows detailed customization through parameters, and supports pagination for efficient data access. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `q` | string | No | search | | `limit` | integer | No | Number of results to return in the collection. | | `access` | array | No | 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. | | `offset` | integer | No | Offset of first result. Deprecated, use `linked_partitioning` instead. | | `show_tracks` | boolean | No | A boolean flag to request a playlist with or without tracks. Default is `true`. | | `linked_partitioning` | boolean | No | Returns paginated collection of items (recommended, returning a list without pagination is deprecated and should not be used) | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Performs a user search based on a query **Slug:** `SOUNDCLOUD_PERFORMS_A_USER_SEARCH_BASED_ON_A_QUERY` The `/users` endpoint on SoundCloud, requiring authentication, supports user searches with parameters like `q`, `ids`, `limit`, and uses `linked_partitioning` for pagination. It returns detailed, paginated user data and related resources. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `q` | string | No | search | | `ids` | string | No | A comma separated list of track ids to filter on | | `limit` | integer | No | Number of results to return in the collection. | | `offset` | integer | No | Offset of first result. Deprecated, use `linked_partitioning` instead. | | `linked_partitioning` | boolean | No | Returns paginated collection of items (recommended, returning a list without pagination is deprecated and should not be used) | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Provisionaccesstokenspostauthorization **Slug:** `SOUNDCLOUD_PROVISION_ACCESS_TOKENS_POST_AUTHORIZATION` The `/oauth2/token` endpoint issues access tokens to authorized apps, accepting two content types and requiring specific fields. It returns a `200` code with token details or errors (`400`, `401`) with messages based on grant type used. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `code` | string | No | Authorization code. Required on `grant_type = authorization_code`. | | `client_id` | string | Yes | Client ID | | `grant_type` | string ("authorization_code" | "refresh_token" | "client_credentials") | Yes | One of `authorization_code`, `client_credentials`, `refresh_token` | | `redirect_uri` | string | No | Redirect URI. Required on `grant_type = (authorization_code|refresh_token)`. | | `client_secret` | string | Yes | Client secret | | `refresh_token` | string | No | Refresh token. Required on `grant_type = refresh_token`. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Recent the authenticated user s activities **Slug:** `SOUNDCLOUD_RECENT_THE_AUTHENTICATED_USER_S_ACTIVITIES` This API endpoint lets authenticated users fetch their SoundCloud activities, like songs and playlists, with filters for access level. It limits results and secures access via 'AuthHeader', returning detailed activity data. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Number of results to return in the collection. | | `access` | array | No | 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. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Recenttracksfromfollowedusers **Slug:** `SOUNDCLOUD_RECENT_TRACKS_FROM_FOLLOWED_USERS` This endpoint lets authenticated users see recent tracks from followed users, offering filter by access level and pagination. Authentication is needed. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Number of results to return in the collection. | | `access` | array | No | 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. | | `offset` | integer | No | Offset of first result. Deprecated, use `linked_partitioning` instead. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Removes a repost on a playlist as the authenticated user **Slug:** `SOUNDCLOUD_REMOVE_PLAYLIST_REPOST` Removes a repost on a playlist as the authenticated user #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `playlist_id` | integer | Yes | SoundCloud playlist id | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Removes a repost on a track as the authenticated user **Slug:** `SOUNDCLOUD_REMOVE_TRACK_REPOST` Removes a repost on a track as the authenticated user #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `track_id` | integer | Yes | SoundCloud Track id | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Reposts a playlist as the authenticated user **Slug:** `SOUNDCLOUD_REPOSTS_A_PLAYLIST_AS_THE_AUTHENTICATED_USER` This endpoint lets authenticated users repost SoundCloud playlists by ID, returning status codes for success (201), unauthorized (401), and not found (404). AuthHeader for security is needed. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `playlist_id` | integer | Yes | SoundCloud playlist id | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Reposts a track as the authenticated user **Slug:** `SOUNDCLOUD_REPOSTS_A_TRACK_AS_THE_AUTHENTICATED_USER` This endpoint lets authenticated users repost tracks on SoundCloud, using track ID and `AuthHeader`. It returns a 201 status for success, and 401 or 404 for authentication errors or missing tracks, respectively. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `track_id` | integer | Yes | SoundCloud Track id | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Resolve soundcloud urls to api resource urls **Slug:** `SOUNDCLOUD_RESOLVE_SOUND_CLOUD_URLS_TO_API_RESOURCE_URLS` This endpoint translates SoundCloud URLs into API Resource URLs, requiring authentication and a `url` parameter. It returns the resolved Resource URL or an error if the URL is not found. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `url` | string | Yes | SoundCloud URL | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Returns a collection of playlist s reposters **Slug:** `SOUNDCLOUD_RETURNS_A_COLLECTION_OF_PLAYLIST_S_REPOSTERS` This endpoint fetches users reposting a SoundCloud playlist using a playlist ID, offering pagination and detailed user profiles. Authentication is required. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Number of results to return in the collection. | | `playlist_id` | integer | Yes | SoundCloud playlist id | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Returns a collection of track s reposters **Slug:** `SOUNDCLOUD_RETURNS_A_COLLECTION_OF_TRACK_S_REPOSTERS` This endpoint fetches users reposting a SoundCloud track. It requires AuthHeader, accepts Track ID, and an optional limit. Responses detail user names, followers, etc. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Number of results to return in the collection. | | `track_id` | integer | Yes | SoundCloud Track id | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Returns a list of the current user s tracks **Slug:** `SOUNDCLOUD_RETURNS_A_LIST_OF_THE_CURRENT_USER_S_TRACKS` This endpoint fetches the user's tracks with options for limiting results and pagination, requiring authentication. It supports queries for efficient data retrieval, returning track details and user interaction metrics. Errors return a 401 status. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Number of results to return in the collection. | | `linked_partitioning` | boolean | No | Returns paginated collection of items (recommended, returning a list without pagination is deprecated and should not be used) | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Returns a list of user s followers **Slug:** `SOUNDCLOUD_RETURNS_A_LIST_OF_USER_S_FOLLOWERS` Returns a list of users that follows (user_id). #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Number of results to return in the collection. | | `user_id` | integer | Yes | SoundCloud User id | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Returns a list of user s followings **Slug:** `SOUNDCLOUD_RETURNS_A_LIST_OF_USER_S_FOLLOWINGS` Returns list of users that (user_id) follows. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Number of results to return in the collection. | | `user_id` | integer | Yes | SoundCloud User id | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Returns a list of user s liked playlists **Slug:** `SOUNDCLOUD_RETURNS_A_LIST_OF_USER_S_LIKED_PLAYLISTS` This endpoint fetches liked playlists for a specified user_id on SoundCloud, supports pagination, and requires authentication. It returns playlists with track details, metadata, and user info, and handles errors for invalid requests. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Number of results to return in the collection. | | `user_id` | integer | Yes | SoundCloud User id | | `linked_partitioning` | boolean | No | Returns paginated collection of items (recommended, returning a list without pagination is deprecated and should not be used) | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Returns a list of user s liked tracks **Slug:** `SOUNDCLOUD_RETURNS_A_LIST_OF_USER_S_LIKED_TRACKS` This endpoint retrieves a SoundCloud user's liked tracks, filtered by access level (playable, preview, blocked), with optional result limit and pagination. Requires user ID and supports secure access. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Number of results to return in the collection. | | `access` | array | No | 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. | | `user_id` | integer | Yes | SoundCloud User id | | `linked_partitioning` | boolean | No | Returns paginated collection of items (recommended, returning a list without pagination is deprecated and should not be used) | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Returns a list of user s playlists **Slug:** `SOUNDCLOUD_RETURNS_A_LIST_OF_USER_S_PLAYLISTS` Fetches a SoundCloud user's playlists by user ID, with options to filter by track access level, include/exclude tracks, and specify result limits. Supports pagination and requires authentication. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Number of results to return in the collection. | | `access` | array | No | 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. | | `user_id` | integer | Yes | SoundCloud User id | | `show_tracks` | boolean | No | A boolean flag to request a playlist with or without tracks. Default is `true`. | | `linked_partitioning` | boolean | No | Returns paginated collection of items (recommended, returning a list without pagination is deprecated and should not be used) | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Returns a list of user s tracks **Slug:** `SOUNDCLOUD_RETURNS_A_LIST_OF_USER_S_TRACKS` Get a user's track collection on SoundCloud by their user ID, including options for filtering by track access level, specifying result limits, and pagination. Requires an AuthHeader for security. Provides track details and user information. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Number of results to return in the collection. | | `access` | array | No | 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. | | `user_id` | integer | Yes | SoundCloud User id | | `linked_partitioning` | boolean | No | Returns paginated collection of items (recommended, returning a list without pagination is deprecated and should not be used) | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Returns a playlist **Slug:** `SOUNDCLOUD_RETURNS_A_PLAYLIST` This endpoint fetches a SoundCloud playlist using its `playlist_id`, with options for a secret token, access filters (like playable or blocked), and including/excluding tracks. Authentication with `AuthHeader` is necessary. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `access` | array | No | 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. | | `playlist_id` | integer | Yes | SoundCloud playlist id | | `show_tracks` | boolean | No | A boolean flag to request a playlist with or without tracks. Default is `true`. | | `secret_token` | string | No | A secret token to fetch private playlists/tracks | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Returns a track **Slug:** `SOUNDCLOUD_RETURNS_A_TRACK` Fetches details of a specific SoundCloud track using its ID, including metadata like title, genre, and artist info. Supports private track access with a secret token. Responses include track details and user interaction data. Security via AuthHeader. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `track_id` | integer | Yes | SoundCloud Track id | | `secret_token` | string | No | A secret token to fetch private playlists/tracks | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Returns a track s streamable urls **Slug:** `SOUNDCLOUD_RETURNS_A_TRACK_S_STREAMABLE_URLS` This endpoint returns streamable URLs for a specific SoundCloud track given its track_id. Requires AuthHeader for access. It supports an optional secret_token query for private content. Responses include URLs for MP3 and HLS formats. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `track_id` | integer | Yes | SoundCloud Track id | | `secret_token` | string | No | A secret token to fetch private playlists/tracks | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Returns a user **Slug:** `SOUNDCLOUD_RETURNS_A_USER` Fetch a SoundCloud user's details by user ID, including profile data, follower stats, and more. Requires AuthHeader. Responses include JSON formatted user details with examples for successful and error outcomes. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `user_id` | integer | Yes | SoundCloud User id | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Returns the authenticated user s activities **Slug:** `SOUNDCLOUD_RETURNS_THE_AUTHENTICATED_USER_S_ACTIVITIES` The `/me/activities` endpoint lets authenticated users access their SoundCloud activities (tracks, playlists) based on access level, requiring `AuthHeader` for security. It returns success (200) with data or unauthorized (401). #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Number of results to return in the collection. | | `access` | array | No | 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. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Returns the authenticated user s information **Slug:** `SOUNDCLOUD_RETURNS_THE_AUTHENTICATED_USER_S_INFORMATION` This endpoint ("/me") supports GET requests to access user info such as avatar, location, and follower stats with "AuthHeader" needed for security. It returns SoundCloud Me object or an error if unauthorized. #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Returns the comments posted on the track track id **Slug:** `SOUNDCLOUD_RETURNS_THE_COMMENTS_POSTED_ON_THE_TRACK_TRACK_ID` This endpoint retrieves comments for a specified track on SoundCloud using track_id. It supports pagination and filtering by result limit. Requires authentication. Responses cover success (200), unauthorized (401), or not found (404) scenarios. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Number of results to return in the collection. | | `offset` | integer | No | Offset of first result. Deprecated, use `linked_partitioning` instead. | | `track_id` | integer | Yes | SoundCloud Track id | | `linked_partitioning` | boolean | No | Returns paginated collection of items (recommended, returning a list without pagination is deprecated and should not be used) | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Returns tracks under a playlist **Slug:** `SOUNDCLOUD_RETURNS_TRACKS_UNDER_A_PLAYLIST` This endpoint retrieves tracks in a given SoundCloud playlist, specified by `playlist_id`. Supports filtering by access level, secret token for private content, and offers pagination. Requires authentication via `AuthHeader`. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `access` | array | No | 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. | | `playlist_id` | integer | Yes | SoundCloud playlist id | | `secret_token` | string | No | A secret token to fetch private playlists/tracks | | `linked_partitioning` | boolean | No | Returns paginated collection of items (recommended, returning a list without pagination is deprecated and should not be used) | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Returns user s playlists sets **Slug:** `SOUNDCLOUD_RETURNS_USER_S_PLAYLISTS_SETS` Returns playlist info, playlist tracks and tracks owner info. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Number of results to return in the collection. | | `show_tracks` | boolean | No | A boolean flag to request a playlist with or without tracks. Default is `true`. | | `linked_partitioning` | boolean | No | Returns paginated collection of items (recommended, returning a list without pagination is deprecated and should not be used) | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Deletes a user who is followed by the authenticated user **Slug:** `SOUNDCLOUD_UNFOLLOW_USER` Deletes a user who is followed by the authenticated user #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `user_id` | integer | Yes | SoundCloud User id | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Unlikes a playlist **Slug:** `SOUNDCLOUD_UNLIKES_A_PLAYLIST` Authenticated users can remove a "like" from a SoundCloud playlist by sending a DELETE request to `/likes/playlists/{playlist_id}`. Success returns a 200 status, failures return 400 or 404 if not found. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `playlist_id` | integer | Yes | SoundCloud playlist id | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Unlikes a track **Slug:** `SOUNDCLOUD_UNLIKES_A_TRACK` Endpoint `/likes/tracks/{track_id}` allows unauthorized liking of a track, requiring AuthHeader. Accepts `track_id` as a path parameter. Responses include 200 (Success), 400 (Bad Request), and 404 (Not Found). #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `track_id` | integer | Yes | SoundCloud Track id | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Updates a playlist **Slug:** `SOUNDCLOUD_UPDATES_A_PLAYLIST` Update existing playlists on SoundCloud by specifying a playlist ID. Requires authentication. Supports updating title, description, sharing status, track list, and various metadata elements. Successful updates return the updated playlist object. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `playlist_id` | integer | Yes | SoundCloud playlist id | | `playlist__ean` | string | No | The European Article Number | | `playlist__genre` | string | No | Playlist"s genre | | `playlist__title` | string | No | Title of the playlist | | `playlist__tracks` | array | No | List of tracks to add to playlist | | `playlist__license` | string | No | License number | | `playlist__release` | string | No | Playlist"s release | | `playlist__sharing` | string ("public" | "private") | No | public or private | | `playlist__permalink` | string | No | Playlist"s permalink | | `playlist__set__type` | string ("album" | "playlist") | No | Playlist or album type | | `playlist__tag__list` | string | No | A comma-separated list of tags | | `playlist__description` | string | No | Description of the playlist | | `playlist__label__name` | string | No | Label name | | `playlist__artwork__data` | string | No | Artwork Data | | `playlist__purchase__url` | string | No | Purchase URL | | `playlist__release__date` | string | No | Release date | | `playlist__permalink__url` | string | No | Full permalink URL | | `playlist__purchase__title` | string | No | Purchase title | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Updates a track s information **Slug:** `SOUNDCLOUD_UPDATES_A_TRACK_S_INFORMATION` Update a track's details on SoundCloud by PUT method at '/tracks/{track_id}'. Requires track ID and authenticated user. Supports JSON, form-data, and x-www-form-urlencoded payload formats. Responses include updated track info or error messages. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `track_id` | integer | Yes | SoundCloud Track id | | `track__isrc` | string | No | Isrc | | `track__genre` | string | No | Genre | | `track__title` | string | No | Title | | `track__license` | string ("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") | No | 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` | string | No | Release | | `track__sharing` | string ("public" | "private") | No | Sharing | | `track__permalink` | string | No | Permalink | | `track__tag__list` | string | No | 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__streamable` | boolean | No | Streamable | | `track__commentable` | boolean | No | Commentable | | `track__description` | string | No | Description | | `track__label__name` | string | No | Label Name | | `track__downloadable` | boolean | No | Downloadable | | `track__purchase__url` | string | No | Purchase Url | | `track__release__date` | string | No | string, formatted as yyyy-mm-dd, representing release date | | `track__embeddable__by` | string ("all" | "me" | "none") | No | who can embed this track "all", "me", or "none" | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Uploads a new track **Slug:** `SOUNDCLOUD_UPLOADS_A_NEW_TRACK` This endpoint enables secure track uploads, requiring track title and asset data. It supports privacy options, attributes, and provides track details and status codes, with security through an AuthHeader. #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Userrecenttrackactivities **Slug:** `SOUNDCLOUD_USER_RECENT_TRACK_ACTIVITIES` This Soundcloud API endpoint fetches recent user tracks, reposts, and playlist adds, allowing access level filtering and result count customization. It requires an "AuthHeader" for secure requests and returns detailed information. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Number of results to return in the collection. | | `access` | array | No | 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. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not |