Skip to content

Releases: soundcloud/api

2026-09-16

Choose a tag to compare

@sc-github-bot sc-github-bot released this 16 Sep 12:28

API Public Release Notes

System playlists, resolve, and station URNs

  • GET /resolve now resolves system playlist permalinks such as https://soundcloud.com/discover/sets/track-stations:2287580618 and redirects to GET /system-playlists/{urn}.
  • GET /system-playlists/{id} returns a system playlist (e.g. track station, artist station) with hydrated visible tracks. Returns 404 when the playlist is missing or has no visible tracks.
  • station_urn is exposed on track and user representations as a single nullable field. When present, it uses the system-playlists URN format (e.g. soundcloud:system-playlists:track-stations:{id} or soundcloud:system-playlists:artist-stations:{id}). Track station_urn is omitted for non-public tracks; user station_urn is omitted when the user has no public tracks.

POST /disconnect to revoke OAuth access for the calling application

  • POST /disconnect invalidates access tokens for the client application that issued the current access token.
  • Returns 204 No Content on success.

2026-08-14

Choose a tag to compare

@sc-github-bot sc-github-bot released this 14 Aug 13:24
1fa6ad1

API Public Release Notes

Track BPM and key signature restored for newer tracks

  • GET /tracks/{track_urn} and other track representations now return bpm and key_signature for tracks where analysis data is available.
  • Fixes #556

Progressive download URL removed from GET /tracks/{track_urn}/streams

  • GET /tracks/{track_urn}/streams no longer returns http_mp3_128_url. HLS stream URLs and preview_mp3_128_url (for snippets) are unchanged.

2026-08-12

Choose a tag to compare

@sc-github-bot sc-github-bot released this 12 Aug 10:10

API Public Release Notes

Progressive download URL removed from GET /tracks/{track_urn}/streams

  • GET /tracks/{track_urn}/streams no longer returns http_mp3_128_url. HLS stream URLs and preview_mp3_128_url (for snippets) are unchanged.

2026-08-11

Choose a tag to compare

@sc-github-bot sc-github-bot released this 11 Aug 15:42

API Public Release Notes

Fixed track storefront updates

  • Fixed an issue that prevented eligible creators from updating track storefronts.

2026-08-10

Choose a tag to compare

@sc-github-bot sc-github-bot released this 10 Aug 11:55

API Public Release Notes

Playlist creation accepts documented set_type=playlist

  • POST /playlists, POST /me/playlists, and playlist update endpoints now accept set_type=playlist as documented.

2026-07-19

Choose a tag to compare

@sc-github-bot sc-github-bot released this 19 Jul 17:07

API Public Release Notes

Sort parameter for user tracks

  • GET /users/{user_urn}/tracks and GET /me/tracks now accept an optional sort query parameter (asc or desc) to control upload-date order. Newest-first (desc) remains the default. direction and order are accepted as aliases.

2026-07-17

Choose a tag to compare

@sc-github-bot sc-github-bot released this 17 Jul 16:25

API Public Release Notes

Follow rejection reason in the 422 response

  • PUT /me/followings/{user_urn} now returns a descriptive message in the 422 response when the follow is rejected — for example when the authenticated user has reached the maximum number of followings. Previously the response body carried an empty message.

2026-07-15

Choose a tag to compare

@sc-github-bot sc-github-bot released this 15 Jul 19:29

API Public Release Notes

Track storefront

  • PUT /tracks/{track_urn}/storefront creates or updates the storefront (Artist Storefront) shown on the track page. The request replaces the whole storefront: omitted optional fields (link_title, description, price) are cleared, so always send every value the storefront should keep. The authenticated user must own the track and hold a creator subscription that includes external purchase options. The storefront links to an external page; no payment is processed by SoundCloud.

2026-06-15

Choose a tag to compare

@sc-github-bot sc-github-bot released this 15 Jun 21:58

API Public Release Notes

Recently played tracks

  • GET /me/recently-played/tracks returns the authenticated user's last 25 recently played tracks as full track objects in reverse chronological order, with duplicate tracks omitted (no pagination).

2026-05-19

Choose a tag to compare

@sc-github-bot sc-github-bot released this 19 May 10:58
75e4c1d

API Public Release Notes

Related artists

  • GET /users/{user_urn}/related returns related artist recommendations for a user, with optional limit, offset, and linked_partitioning (same pagination style as GET /tracks/{track_urn}/related).