---
title: "Get Playlist Snapshot on a Date"
method: GET
path: "/api/playlist/{platform}/{id}/snapshot"
tags: ["Playlist"]
---

# Get Playlist Snapshot on a Date

`GET /api/playlist/{platform}/{id}/snapshot`

## Request

- Base URL: `https://api.chartmetric.com`
- URL: `https://api.chartmetric.com/api/playlist/{platform}/{id}/snapshot`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/docs/api/playlist/:platform/:id/snapshot/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the tracks that were on the playlist on the given `date`, each enriched with basic track info (name, ISRC, artists, album metadata).

## Path parameters

- `id` unknown, required
- `platform` 'cm' | 'spotify' | 'itunes' | 'applemusic' | 'deezer' | 'shazam' | 'beatport' | 'amazon' | 'youtube' | 'tunefind' | 'soundcloud', required: Streaming platform. One of `spotify`, `applemusic` (aliased to `itunes`), `deezer`, `amazon`, `youtube`, `soundcloud`.

## Query parameters

- `storefront` string: ISO 3166-1 alpha-2 country code (2 letters, e.g. 'US', 'BR', 'GB').
- `date` string, date-time, required: Snapshot date. Returns the tracks that were on the playlist on this date (`YYYY-MM-DD`).

## Response `200`

Success

- object
  - `obj` object[], required
    - `track_id` integer: Internal track-row ID.
    - `id` integer: Internal track-row ID.
    - `added_at` string, date-time, nullable: Date when the track was added to the playlist.
    - `removed_at` string, date-time, nullable: Date when the track was detected as no longer being on the playlist; null if still present.
    - `position` integer, nullable: Track's position in the playlist (1-indexed).
    - `name` string, nullable: Track name.
    - `isrc` string, nullable: International Standard Recording Code (ISRC) of the track.
    - `spotify_track_id` string, nullable: Spotify track ID.
    - `spotify_album_id` string, nullable: Spotify album ID for the album containing the track.
    - `image_url` string, nullable: Album cover image URL.
    - `spotify_popularity` integer, nullable: Spotify's 0–100 popularity score for the track.
    - `cm_track` integer: Chartmetric track ID.
    - `spotify_artist_names` string[], nullable: Artist display names as they appear on Spotify.
    - `track_genre` string, nullable: Comma-separated list of genres associated with the track.
    - `cm_artist` integer[], nullable: Chartmetric artist IDs for the credited artists.
    - `artist_names` string[], nullable: Artist display names from Chartmetric.
    - `code2s` string[], nullable: Country codes (ISO 3166-1 alpha-2) of the credited artists' origins.
    - `artist_images` string[], nullable: Profile image URLs for the credited artists.
    - `artist_covers` string[], nullable: Cover image URLs for the credited artists.
    - `spotify_artist_ids` string[], nullable: Spotify artist IDs for the credited artists.
    - `spotify_track_ids` string[], nullable: All Spotify track IDs that map to this Chartmetric track (covers re-releases).
    - `spotify_album_ids` string[], nullable: All Spotify album IDs that contain this track.
    - `spotify_duration_ms` integer, nullable: Track duration in milliseconds (Spotify).
    - `album_ids` integer[], nullable: Chartmetric album IDs for the albums containing this track.
    - `album_names` string[], nullable: Album titles.
    - `album_upc` string[], nullable: Universal Product Codes (UPC) for the albums.
    - `album_label` string[], nullable: Record labels that released the albums.
    - `release_dates` string[], nullable: Album release dates.
    - `preview_url` string, nullable: Spotify 30-second preview URL for the track, if available.
    - `storefront` string, nullable: Storefront the snapshot was taken from (e.g. 'us' for Apple Music).

---

[API](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api.md) - [All operations](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/revisions/94dac96833a3?raw)