Songstats · Schema

Songstats Track

A music track in the Songstats platform with streaming analytics data.

AnalyticsMusicStreamingArtistsTracksLabels

Properties

Name Type Description
songstats_track_id string Songstats internal track identifier
title string Track title
artists array Artist names associated with this track
isrc stringnull International Standard Recording Code
release_date stringnull Track release date (YYYY-MM-DD)
genres array Music genres associated with this track
links object Platform-specific links for the track
stats object Current streaming statistics (from /tracks/stats)
View JSON Schema on GitHub

JSON Schema

songstats-track-schema.json Raw ↑ 
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/songstats/main/json-schema/songstats-track-schema.json",
  "title": "Songstats Track",
  "description": "A music track in the Songstats platform with streaming analytics data.",
  "type": "object",
  "properties": {
    "songstats_track_id": {
      "type": "string",
      "description": "Songstats internal track identifier"
    },
    "title": {
      "type": "string",
      "description": "Track title"
    },
    "artists": {
      "type": "array",
      "items": {"type": "string"},
      "description": "Artist names associated with this track"
    },
    "isrc": {
      "type": ["string", "null"],
      "description": "International Standard Recording Code"
    },
    "release_date": {
      "type": ["string", "null"],
      "format": "date",
      "description": "Track release date (YYYY-MM-DD)"
    },
    "genres": {
      "type": "array",
      "items": {"type": "string"},
      "description": "Music genres associated with this track"
    },
    "links": {
      "type": "object",
      "description": "Platform-specific links for the track",
      "properties": {
        "spotify": {"type": "string"},
        "apple_music": {"type": "string"},
        "deezer": {"type": "string"},
        "amazon_music": {"type": "string"},
        "tidal": {"type": "string"},
        "youtube": {"type": "string"}
      }
    },
    "stats": {
      "type": "object",
      "description": "Current streaming statistics (from /tracks/stats)",
      "properties": {
        "source": {"type": "string"},
        "streams": {"type": "integer"},
        "playlists_editorial_current": {"type": "integer"},
        "playlists_editorial_total": {"type": "integer"},
        "chart_position": {"type": ["integer", "null"]}
      }
    }
  },
  "required": ["songstats_track_id", "title"]
}