Song V 2 Collection

Description

Properties

Property Description
items read-only

List of songs.

meta
Property Description
isFailedSearch read-only

Whether the search fell back to a broader result set.

totalRows read-only

Total number of matching songs.

similarityRow nullable read-only

The anchor song used for similarity search, if applicable.

Property Description
artistImageFileName nullable read-only

Artist image file name. Combine with imageBaseUrl from /song/options to build a full URL.

artistImageUrls nullable read-only

Pre-built artist image URLs at standard widths (46, 92, 150, 300px).

artistName nullable read-only

Artist name.

bpm nullable read-only

Beats per minute.

chorusRegions read-only

Normalized time regions (0–1) for Smart Preview — the best segment to preview a song. Sourced from TSM chorusRegions or smartPreviewRegions.

durationDisplay nullable read-only

Human-readable duration (e.g. "3:45").

durationSeconds read-only

Duration of the song in seconds.

id read-only

TSM v2 song identifier.

lyrics nullable read-only

Song lyrics.

similarityHighlightRegions read-only

Time regions highlighted when this song is used as a similarity reference.

title nullable read-only

Song title.

topGenreIds read-only

The top genre IDs for the song.

topGenreNames read-only

Display names for the top genres, aligned with topGenreIds. Unknown ids are omitted.

topMoodIds read-only

The top mood IDs for the song.

topMoodNames read-only

Display names for the top moods, aligned with topMoodIds. Unknown ids are omitted.

type read-only
waveFormData nullable read-only

Compressed waveform data string.

type read-only

OpenAPI Schema

The following schema is based on OpenAPI 3.0 and is provided in our downloadable OpenAPI document.

{
  "properties": {
    "items": {
      "description": "List of songs.",
      "items": {
        "$ref": "#/components/schemas/SongV2"
      },
      "readOnly": true,
      "type": "array"
    },
    "meta": {
      "properties": {
        "isFailedSearch": {
          "description": "Whether the search fell back to a broader result set.",
          "readOnly": true,
          "type": "boolean"
        },
        "totalRows": {
          "description": "Total number of matching songs.",
          "readOnly": true,
          "type": "integer"
        }
      },
      "type": "object"
    },
    "similarityRow": {
      "allOf": [
        {
          "$ref": "#/components/schemas/SongV2"
        }
      ],
      "description": "The anchor song used for similarity search, if applicable.",
      "nullable": true,
      "readOnly": true
    },
    "type": {
      "enum": [
        "song-collection"
      ],
      "readOnly": true,
      "type": "string"
    }
  },
  "title": "Collection of songs (v2)",
  "type": "object"
}