SoundCloud logo

SoundCloud

SoundCloud API provides access to a wide range of SoundCloud features for playing, uploading, and managing sounds.

51 actions Integration catalog
Request access
Connect SoundCloud once you're in Boring.
01 · WHAT THE AGENT CAN DO

Actions

Every capability is a discrete, logged action the agent calls by name — scoped to what you authorize and recorded in the run trace.

Creates a playlistSOUNDCLOUD_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 playlistSOUNDCLOUD_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 trackSOUNDCLOUD_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.
Fetch soundcloud follower profile detailsSOUNDCLOUD_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).
FetchuserfavoritesSOUNDCLOUD_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.
FetchuserfollowingdetailsSOUNDCLOUD_FETCH_USER_FOLLOWING_DETAILS
Returns (following_id) that is followed by (user_id).
FetchuserprofileslinksSOUNDCLOUD_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.
Follows a userSOUNDCLOUD_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.
GetfolloweruserdetailsSOUNDCLOUD_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.
Returns all related tracks of track on SoundCloudSOUNDCLOUD_GET_RELATED_TRACKS
Returns all related tracks of track on SoundCloud
Returns a list of users who have favorited or liked the trackSOUNDCLOUD_GET_TRACK_LIKERS
Returns a list of users who have favorited or liked the track
Likes a playlistSOUNDCLOUD_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 trackSOUNDCLOUD_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.
ListauthenticateduserfollowersSOUNDCLOUD_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.
ListfollowedbyuserSOUNDCLOUD_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.
ListuserfavoritesSOUNDCLOUD_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.
Oauth2 authorization redirect handlerSOUNDCLOUD_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 querySOUNDCLOUD_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 querySOUNDCLOUD_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.
ProvisionaccesstokenspostauthorizationSOUNDCLOUD_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.
Recent the authenticated user s activitiesSOUNDCLOUD_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.
RecenttracksfromfollowedusersSOUNDCLOUD_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.
Removes a repost on a playlist as the authenticated userSOUNDCLOUD_REMOVE_PLAYLIST_REPOST
Removes a repost on a playlist as the authenticated user
Removes a repost on a track as the authenticated userSOUNDCLOUD_REMOVE_TRACK_REPOST
Removes a repost on a track as the authenticated user
Reposts a playlist as the authenticated userSOUNDCLOUD_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 userSOUNDCLOUD_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 urlsSOUNDCLOUD_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.
Returns a collection of playlist s repostersSOUNDCLOUD_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 repostersSOUNDCLOUD_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 tracksSOUNDCLOUD_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.
Returns a list of user s followersSOUNDCLOUD_RETURNS_A_LIST_OF_USER_S_FOLLOWERS
Returns a list of users that follows (user_id).
Returns a list of user s followingsSOUNDCLOUD_RETURNS_A_LIST_OF_USER_S_FOLLOWINGS
Returns list of users that (user_id) follows.
Returns a list of user s liked playlistsSOUNDCLOUD_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 tracksSOUNDCLOUD_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 playlistsSOUNDCLOUD_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 tracksSOUNDCLOUD_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 playlistSOUNDCLOUD_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 trackSOUNDCLOUD_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.
Returns a track s streamable urlsSOUNDCLOUD_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 userSOUNDCLOUD_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 activitiesSOUNDCLOUD_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 informationSOUNDCLOUD_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 idSOUNDCLOUD_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.
Returns tracks under a playlistSOUNDCLOUD_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 setsSOUNDCLOUD_RETURNS_USER_S_PLAYLISTS_SETS
Returns playlist info, playlist tracks and tracks owner info.
Deletes a user who is followed by the authenticated userSOUNDCLOUD_UNFOLLOW_USER
Deletes a user who is followed by the authenticated user
Unlikes a playlistSOUNDCLOUD_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 trackSOUNDCLOUD_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 playlistSOUNDCLOUD_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.
Updates a track s informationSOUNDCLOUD_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.
Uploads a new trackSOUNDCLOUD_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.
UserrecenttrackactivitiesSOUNDCLOUD_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.