The song object

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

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.
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
    ],
    "stems": "https://cdn.soundstripe.com/.../The_Dread.zip?key=YOUR_API_KEY&token=...",
    "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"
        }
      ]
    }
  }
}