rss-bridge 2021-03-16T00:00:00+00:00

SoundCloud’s New API Track Object

As a part of our efforts to improve API use, we’re introducing a new object that’s more up to date with our current data model. The…

---

SoundCloud’s New API Track Object

March 16th, 2021 by Dasha Kobzeva

As a part of our efforts to improve API use, we’re introducing a new Track object that’s more up to date with our current data model. The following change is also intended to standardize and simplify the response data. A new object will be used for all endpoints returning track-related information, for example:

- /playlist/:playlist_id/tracks

- /tracks

- /tracks/:track_id

New Track Object

The following shows a schema of our new Track model:

`
"artwork_url": Option[String],
"available_country_codes": Option[HashSet[String]],
"bpm": Option[Int],
"comment_count": Option[Int],
"commentable": Boolean,
"description": Option[String],
"download_url": Option[String],
"download_count": Option[Int],
"downloadable": Boolean,
"duration": Int,
"favoritings_count": Option[Int],
"genre": Option[String],
"id": Long,
"isrc": Option[String],
"is_explicit": Option[Boolean],
"key_signature": Option[String],
"kind": String,
"label_name": Option[String],
"license": String,
"playback_count": Option[Int],
"purchase_title": Option[String],
"purchase_url": Option[String],
"release": Option[String],
"release_day": Option[Int],
"release_month": Option[Int],
"user_favorite": Option[Boolean],
"user_playback_count": Option[Int],
"waveform_url": String
`

Deprecated Fields

In the next couple weeks, we’re planning on removing the following deprecated fields from the response. These fields are either superfluous, outdated, or not in use by developers:

- downloads_remaining

- domain_lockings

- embeddable_by

- label

- label_id

- last_modified

- permalink

- originalcontentsize

- original_format

- secret_token

- state

- track_type

- user_id

- user_uri

- video_url

If your application is using the Track object and/or deprecated fields, please update your API in a timely manner. If you deem any of the above fields necessary for your use case and want them to be preserved, please let us know by filing a feature request on our issue tracker by 31 March 2021.

---

- ← Building a Healthy On-Call Culture
- How to Successfully Hand Over Systems →

---

[Original source](https://developers.soundcloud.com/blog/soundclouds-new-api-track-object)