--- title: "Get Track Playlist Snapshot by Date" method: GET path: "/api/track/{id}/{platform}/playlists/snapshot" tags: ["Track"] --- # Get Track Playlist Snapshot by Date `GET /api/track/{id}/{platform}/playlists/snapshot` ## Request - Base URL: `https://api.chartmetric.com` - URL: `https://api.chartmetric.com/api/track/{id}/{platform}/playlists/snapshot` - Auth: HTTP bearer - TypeScript: (a function with typed inputs; its response is checked against the schema) Return the playlists a track belonged to on the given `date`. `platform` accepts `spotify`, `applemusic` (aliased to `itunes`), or `deezer`. Each entry pairs the playlist info with the track info at that snapshot. ## Path parameters - `id` integer, required: Chartmetric track ID. - `platform` 'spotify' | 'applemusic' | 'itunes' | 'deezer', required: Streaming platform. One of `spotify`, `applemusic` (aliased to `itunes`), or `deezer`. ## Query parameters - `date` string, date-time, required: Snapshot date in `YYYY-MM-DD` format. Returns playlists the track was on as of this date. - `offset` integer: Number of items to skip from the start of the result set; pair with `limit` to paginate. - `limit` integer: Maximum number of playlists to return. Max 100. ## Response `200` Success - object - `obj` object[] - `playlist_id` union: Chartmetric playlist ID. May arrive as numeric or string. - number, float - string - `track_id` union: Internal track ID for the playlist-track pairing. Prefer `track.cm_track` for stable cross-reference. - number, float - string - `added_at` string, date-time, nullable: Timestamp when the track was added to the playlist. - `removed_at` string, date-time, nullable: Timestamp when the track was removed from the playlist; null if still on it. - `playlist` object, nullable: Playlist metadata at the snapshot date. - `id` integer: Chartmetric playlist ID. - `name` string, nullable: Playlist name. - `playlist_id` string, nullable: Native playlist ID on the source platform (e.g. Spotify playlist URI suffix). - `description` string, nullable: Playlist description as set by the curator. - `image_url` string, nullable: URL of the playlist cover artwork. - `sys_last_updated` string, date-time, nullable: Timestamp of the last Chartmetric stats refresh for this playlist. - `last_updated` string, date-time, nullable: Timestamp of the last upstream playlist update from the platform. - `personalized` boolean, nullable: True if the playlist is personalized (e.g. Discover Weekly, Release Radar) and varies per listener. - `code2` string, nullable: ISO 3166-1 alpha-2 country code where the playlist is targeted (e.g. 'US'). - `owner_name` string, nullable: Display name of the playlist curator/owner. - `owner_id` integer, nullable: Chartmetric curator ID of the playlist owner. - `user_id` string, nullable: Native user ID of the playlist owner on the source platform. - `editorial` boolean, nullable: True if the playlist is curated by an official editorial team. Applies to Spotify, Apple Music, and Deezer. - `tags` object[], nullable: Genre/mood tags applied to the playlist. - `id` integer: Chartmetric tag ID. - `name` string: Tag name (e.g. genre or mood label). - `followers` union: Current follower count of the playlist. May arrive as numeric or string. - number, float - string - `num_track` union: Number of tracks in the playlist. May arrive as numeric or string. - number, float - string - `fdiff_week` union: Week-over-week change in followers (`followers` minus the count seven days ago). - number, float - string - `fdiff_month` union: Month-over-month change in followers (`followers` minus the count thirty days ago). - number, float - string - `catalog` string, nullable: Catalog classification for the playlist (e.g. `catalogue`, `current`). - `active_ratio` number, float, nullable: Fraction (0–1) of the playlist tracks that are recently active per Chartmetric heuristics. - `track` object, nullable: Track metadata at the snapshot date. - `id` integer: Chartmetric track ID. - `cm_track` integer: Chartmetric track ID. Same value as `id`. - `name` string, nullable: Track title. - `isrc` string, nullable: International Standard Recording Code identifying the recording. - `image_url` string, nullable: URL of the track artwork. - `spotify_popularity` integer, nullable: Spotify popularity score (0–100, higher is more popular). - `spotify_duration_ms` integer, nullable: Track duration on Spotify in milliseconds. - `cm_artist` integer[], nullable: Chartmetric artist IDs of the credited artists, ordered by main-artist-first. - `artist_names` string[], nullable: Display names of the credited artists, aligned with `cm_artist`. - `spotify_artist_ids` string[], nullable: Spotify artist IDs of the credited artists. - `spotify_artist_names` string[], nullable: Spotify display names of the credited artists. - `spotify_track_ids` string[], nullable: Spotify track IDs linked to this Chartmetric track. - `spotify_album_ids` string[], nullable: Spotify album IDs containing this track. - `itunes_artist_ids` string[], nullable: iTunes/Apple Music artist IDs of the credited artists. - `itunes_artist_names` string[], nullable: iTunes/Apple Music display names of the credited artists. - `itunes_track_ids` string[], nullable: iTunes/Apple Music track IDs linked to this Chartmetric track. - `itunes_album_ids` string[], nullable: iTunes/Apple Music album IDs containing this track. - `code2s` string[], nullable: ISO 3166-1 alpha-2 country codes associated with the credited artists (e.g. 'US', 'BR'). - `artist_images` string[], nullable: Profile image URLs of the credited artists. - `artist_covers` string[], nullable: Cover/banner image URLs of the credited artists. - `album_ids` integer[], nullable: Chartmetric album IDs that contain this track. - `album_names` string[], nullable: Album titles aligned with `album_ids`. - `album_upc` string[], nullable: Universal Product Codes for the albums in `album_ids`. - `album_label` string[], nullable: Record labels for the albums in `album_ids`. - `release_dates` string[], nullable: Release dates for the albums in `album_ids`, in `YYYY-MM-DD` or ISO-8601 form. - `storefronts` string[], nullable: Apple Music storefront codes where the track was charted. - `track_genre` union: Genre labels for the track. Either a comma-separated string or an array, depending on source. - string - unknown[] - unknown --- [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)