ChronicleSchema

A ListenAction for one play in Spotify's recently played list. The agent is the Spotify account, keyed by its handle. The object is a MusicRecording with its duration, its artist, and the MusicAlbum it appears on through inAlbum. The album cover is the recording's emblem, an ImageObject with a width and height.

{
  "@type": "ListenAction",
  "@key": ["@type", "source", "agent.handle", "object.sourceId", "timestamp"],
  "source": "spotify",
  "timestamp": "2026-05-09T16:04:51.000Z",
  "agent": {
    "@type": "Agent",
    "@key": ["@type", "source", "handle"],
    "source": "spotify",
    "handle": "pat",
    "name": "Pat Example",
    "url": "https://open.spotify.com/user/pat",
    "sameAs": ["@me"]
  },
  "object": {
    "@type": "MusicRecording",
    "@key": ["@type", "source", "sourceId"],
    "source": "spotify",
    "sourceId": "6mT8qR2vN5xK9pL3bH7wC4",
    "url": "https://open.spotify.com/track/6mT8qR2vN5xK9pL3bH7wC4",
    "name": "Morning Light",
    "duration": "PT215S",
    "artist": [
      {
        "@type": "MusicGroup",
        "@key": ["@type", "source", "sourceId"],
        "source": "spotify",
        "sourceId": "4kQ7wN2pR8sT1vX3yZ5bC6",
        "url": "https://open.spotify.com/artist/4kQ7wN2pR8sT1vX3yZ5bC6",
        "name": "The Example Band"
      }
    ],
    "inAlbum": {
      "@type": "MusicAlbum",
      "@key": ["@type", "source", "sourceId"],
      "source": "spotify",
      "sourceId": "1bD4fG7hJ9kL2mN5pQ8rS3",
      "url": "https://open.spotify.com/album/1bD4fG7hJ9kL2mN5pQ8rS3",
      "name": "Morning Songs",
      "datePublished": "2024-03-01"
    },
    "emblem": {
      "@type": "ImageObject",
      "@key": ["url"],
      "url": "https://images.example.com/covers/morning-songs.jpg",
      "width": 640,
      "height": 640
    }
  }
}

Terms in this example

ListenActionMusicAlbumMusicGroupMusicRecordingartistdurationemblemheightinAlbumwidth

Esc

↑↓ to move↵ to open/ or ⌘K to search