SoundCloud

Tools

• 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.

• 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.

• 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.

• Deletes a user who is followed by the authenticated user

  Deletes a user who is followed by the authenticated user

• Fetch soundcloud 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).

• Fetchuserfavorites

  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.

• Fetchuserfollowingdetails

  Returns (following_id) that is followed by (user_id).

• Fetchuserprofileslinks

  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.

• 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.

• Getfolloweruserdetails

  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.

• 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.

• 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.

• Listauthenticateduserfollowers

  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.

• Listfollowedbyuser

  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.

• Listuserfavorites

  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

• 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.

• 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.

• 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.

• Provisionaccesstokenspostauthorization

  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.

• 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.

• Recenttracksfromfollowedusers

  This endpoint lets authenticated users see recent tracks from followed users, offering filter by access level and pagination. Authentication is needed.

• Removes a repost on a playlist as the authenticated user

  Removes a repost on a playlist as the authenticated user

• Removes a repost on a track as the authenticated user

  Removes a repost on a track as the authenticated user

• 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.

• 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.

• Resolve soundcloud 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.

• 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.

• 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.

• 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

• Returns a list of user s followers

  Returns a list of users that follows (user_id).

• Returns a list of user s followings

  Returns list of users that (user_id) follows.

• 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.

• 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.

• 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.

• 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.

• Returns a list of users who have favorited or liked the track

  Returns a list of users who have favorited or liked the track

• Returns all related tracks of track on SoundCloud

  Returns all related tracks of track on 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.

• 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 A

• 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.

• 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.

• 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).

• 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.

• 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) scenar

• 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`.

• Returns user s playlists sets

  Returns playlist info, playlist tracks and tracks owner info.

• 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.

• 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).

• 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 ob

• 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 messa

Works well with

How Switchy teams use it

Starter prompts

@SoundCloud Create a new playlist called 'Q2 Campaign Soundtrack' with the description 'Upbeat tracks for our spring product launch videos'. Add the three most recent tracks from my uploads.

@SoundCloud Show me my current follower count and list the five users who followed me most recently, including their profile links.

@SoundCloud List all tracks I've uploaded in the past 30 days, including title, play count, and permalink. Format as a markdown table.

@SoundCloud Fetch my 10 most recently liked playlists and summarize each one's theme based on the track titles and descriptions.

@SoundCloud Show me all my playlists that have fewer than three tracks or haven't been updated in six months. Suggest which ones to delete.