ClipV2

A playable clip with its track details embedded. Returned in the same shape from /v2/clips, /v2/tracks/{id}/clips, and /v2/collections/{id}/clips.

idintegerrequired

startMsintegerrequired

Clip.clipStartMs (drop clip prefix).

stopMsintegerrequired

Clip.clipEndMs (drop clip prefix).

durationMsintegerrequired

Computed: stopMs - startMs.

transcode objectrequired

A playable transcode. url is signed per request; expiresAt is the signing time.

idintegerrequired

urlstringrequired

Signed CDN URL.

expiresAtdate-timerequired

Signing-time expiry.

encodingstringrequired

bitrateintegerrequired

containerstringrequired

Container format (mp3 or mp4).

gainnumbernullablerequired

Always present: a number on track transcodes, and null on clip transcodes.

track objectrequired

Track identity and attribution. Appears on each clip as track.

idintegerrequired

isrcstringrequired

titlestringrequired

artistNamestringrequired

The track's artist name.

releaseTitlestringrequired

Track.releaseTitle (pass-through).

explicitnessExplicitness (string)required

Explicitness status of the track

Possible values: [explicit, clean, censored, unknown]

artwork objectnullablerequired

The track's artwork, or null when the track has no artwork.

urlstringrequired

Signed CDN URL.

expiresAtdate-timerequired

Signing-time expiry.

widthintegerrequired

heightintegerrequired

ClipV2

{
  "id": 0,
  "startMs": 0,
  "stopMs": 0,
  "durationMs": 0,
  "transcode": {
    "id": 0,
    "url": "string",
    "expiresAt": "2024-07-29T15:51:28.071Z",
    "encoding": "string",
    "bitrate": 0,
    "container": "string",
    "gain": 0
  },
  "track": {
    "id": 0,
    "isrc": "string",
    "title": "string",
    "artistName": "string",
    "releaseTitle": "string",
    "explicitness": "explicit",
    "artwork": {
      "url": "string",
      "expiresAt": "2024-07-29T15:51:28.071Z",
      "width": 0,
      "height": 0
    }
  }
}