The song object

Songs are the main resource in Soundstripe. Songs will have one or more audio files and artists attached to them.

Every v1 endpoint that returns a song uses this attribute set, whether the song is the primary resource or is included alongside a playlist. Supe Search returns the same attributes plus has_vocal_version and has_instrumental_version.

Attributes

Attribute	Type	Description
description	`string`	A short description of the song. This can be an empty string.
bpm	`integer` or `null`	Beats per minute, or `null` when no BPM is available.
explicit	`boolean`	Whether or not the song has explicit lyrics.
energy	`string`	The song's energy level: `very_low`, `low`, `medium`, or `high`.
isrc	`string` or `null`	The song's ISRC (International Standard Recording Code): a 12-character uppercase alphanumeric code. A song is assigned an ISRC only once it has been released to digital streaming platforms (Spotify, Apple Music, etc.), so this is `null` for songs that are not yet on those platforms.
lyrics	`string`	The song's lyrics. This can be an empty string.
playlist_ids	`array<integer>`	IDs of the curated playlists that include this song and are available to your API key.
released_at	`integer` or `null`	UTC instant when the song was released on Soundstripe, expressed as whole Unix epoch seconds (not milliseconds), or `null` when no release timestamp is recorded.
stems	`string` or `null`	A time-limited URL for the song's stems bundle, or `null` when stems are unavailable or still processing.
key	`object`	Song musical key. name [`string`]: The name of the key. For instance, `Ab/G#`. mode [`string`]: The key's mode. For instance, `major`.
tags	`object`	Tag names by category. characteristic [`array<string>`]: Characteristics genre [`array<string>`]: Genres instrument [`array<string>`]: Instruments mood [`array<string>`]: Moods
title	`string`	Song title

Example

{
  "id": "1",
  "type": "songs",
  "attributes": {
    "bpm": 110,
    "description": "A cinematic, suspenseful instrumental cue.",
    "energy": "low",
    "explicit": false,
    "isrc": "USABC1234567",
    "key": {
      "name": "A",
      "mode": "major"
    },
    "lyrics": "",
    "playlist_ids": [
      4012
    ],
    "released_at": 1751328000,
    "stems": "https://cdn.soundstripe.com/.../The_Dread.zip",
    "tags": {
      "characteristic": [
        "Minimal",
        "Droning"
      ],
      "genre": [
        "Soundtrack / Cinematic"
      ],
      "instrument": [
        "Strings",
        "Ambient Tones"
      ],
      "mood": [
        "Scary",
        "Suspenseful"
      ]
    },
    "title": "The Dread"
  },
  "relationships": {
    "artists": {
      "data": [
        {
          "id": "1",
          "type": "artists"
        }
      ]
    },
    "audio_files": {
      "data": [
        {
          "id": "1",
          "type": "audio_files"
        }
      ]
    }
  }
}

When no release timestamp is recorded, the response contains "released_at": null; it does not omit the attribute.