Skip to content

Releases: soundcloud/api

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

2026-05-07

Choose a tag to compare

@sc-github-bot sc-github-bot released this 07 May 11:10
75e4c1d

API Public Release Notes

Unsupported track transcodings

  • fixes #534 where unplayable tracks were returned as playable but then 403 was returned when trying to play
  • The /streams JSON payload no longer emits keys with null values. Optional URL fields are omitted entirely when not applicable, instead of "field": null.

<<<<<<< dan/repostuser

Add reposter to activities/feed

  • GET /me/activities, GET /me/feed, GET /me/activities/tracks, GET /me/feed/tracks (and related stream endpoints) now include a reposter field on repost activities.
  • For items with type track:repost or playlist:repost, the response includes reposter with the URN of the user who reposted (e.g. "soundcloud:users:123").
  • Non-repost items (e.g. track, playlist) do not include reposter.
  • fixes issue: #20

=======

master

2026-05-06

Choose a tag to compare

@sc-github-bot sc-github-bot released this 06 May 13:33
75e4c1d

API Public Release Notes

Unsupported track transcodings

  • fixes #534 where unplayable tracks were returned as playable but then 403 was returned when trying to play
  • The /streams JSON payload no longer emits keys with null values. Optional URL fields are omitted entirely when not applicable, instead of "field": null.

2026-03-24

Choose a tag to compare

@sc-github-bot sc-github-bot released this 24 Mar 08:36
75e4c1d

API Public Release Notes

List user reposts (tracks and playlists)

  • GET /me/reposts/tracks – Returns the authenticated user's track reposts (cursor-based pagination, supports linked_partitioning and access).
  • GET /me/reposts/playlists – Returns the authenticated user's playlist reposts (cursor-based pagination, supports linked_partitioning).
  • GET /users/{user_urn}/reposts/tracks – Returns a user's track reposts (cursor-based pagination, supports linked_partitioning and access).
  • GET /users/{user_urn}/reposts/playlists – Returns a user's playlist reposts (cursor-based pagination, supports linked_partitioning).

Implements api#62 and api#379.

Quiet mode (reveal_stats / reveal_comments)

Tracks now support quiet mode attributes so creators can hide stats and comments.

  • reveal_stats (boolean): When false, play count and favorite count are hidden on the track. Default is true.
  • reveal_comments (boolean): When false, comments are hidden on the track. Default is true.

You can set these when creating or updating a track (JSON body or form params). They are returned in the track representation. See API issue #257.

2026-03-23

Choose a tag to compare

@sc-github-bot sc-github-bot released this 23 Mar 11:17
75e4c1d

API Public Release Notes

Fixed

  • GET /tracks with only urns or ids (fixes #363)

2025-06-24

Choose a tag to compare

@sc-github-bot sc-github-bot released this 24 Jun 10:37
668967f

downloadCounts is deprecated in the response for write operations on tracks (create, update) and will be removed soon

2025-04-23

Choose a tag to compare

@sc-github-bot sc-github-bot released this 23 Apr 11:17
668967f

Updated Swagger and Open Api Spec: deprecation of numeric IDs, replaced by string URN

2025-04-21

Choose a tag to compare

@sc-github-bot sc-github-bot released this 21 Apr 19:10
668967f

Introduce strings URN that replace current numeric id in requests and responses