--- title: "Get Track Metadata by ID" method: GET path: "/api/track/{id}" tags: ["Track"] --- # Get Track Metadata by ID `GET /api/track/{id}` ## Request - Base URL: `https://api.chartmetric.com` - URL: `https://api.chartmetric.com/api/track/{id}` - Auth: HTTP bearer - TypeScript: (a function with typed inputs; its response is checked against the schema) Fetch a single Chartmetric track with full metadata: artists, albums, tags/genres, moods, activities, release info, and aggregated `cm_statistics` spanning Spotify, YouTube, TikTok, Shazam, Pandora, Genius, and Boomplay counters. Response may contain additional undocumented fields that can change over time. ## Path parameters - `id` integer, required: Chartmetric track ID. ## Response `200` Success - object - `obj` object, required - `id` integer, required: Chartmetric track ID. - `name` string, nullable: Track title. - `local_name` string, nullable: Localized track title, when available. - `local_name_locale` string, nullable: Locale for local_name, when available. - `isrc` string, nullable: International Standard Recording Code identifying the recording. - `image_url` string, nullable: URL of the track artwork. - `preview_url` string, nullable: URL of a short audio preview clip, if available. - `duration_ms` union: Track duration in milliseconds. May arrive as numeric or string from ES. - integer - string - `composer_name` string, nullable: Track composer name (free-text, often `N/A`). - `track_tier` integer, nullable: Chartmetric track tier classification. - `artists` object[], required: Credited artists, ordered by main-artist-first. May include additional fields from the artist record. - `id` integer, required: Chartmetric artist ID. - `name` string, nullable: Artist display name. - `albums` object[], required: Albums that contain this track. - `id` integer: Chartmetric album ID. - `name` string, nullable: Album title. - `upc` string, nullable: Universal Product Code identifying the release. - `release_date` string, date-time, nullable: Album release date. - `label` string, nullable: Record label that released the album. - `image_url` string, nullable: URL of the album artwork. - `popularity` integer, nullable: Album popularity score on the source platform. - `tags` string, nullable: Comma-separated genre/tag labels for the track. - `moods` object[], nullable: Mood tags applied to the track. - `id` integer, nullable: Chartmetric mood ID. - `name` string, nullable: Mood label. - `activities` object[], nullable: Activity tags applied to the track. - `id` integer, nullable: Chartmetric activity ID. - `name` string, nullable: Activity label (e.g. workout, study). - `genres` unknown[], nullable: Genre objects applied to the track. - unknown - `songwriters` string[], nullable: Songwriter names credited on the track. - `cm_songwriters` unknown[], nullable: Chartmetric songwriter records linked to the track. - unknown - `release_date` string, date-time, nullable: Release date of the track's earliest album. - `album_label` string, nullable: Label name of the track's earliest album. - `explicit` boolean, nullable: True if the track is flagged as explicit. - `score` number, float, nullable: Chartmetric track score (composite popularity metric). - `track_stage` unknown - `career_health` unknown - `cm_statistics` object, nullable: Aggregated platform counters. Large counters (streams, views, playlist reach) surface as strings from uncast PG aggregates; small bounded counts stay numeric. Additional undocumented platform counters may appear as new sources are integrated. - `cm_track` integer, nullable: Chartmetric track ID (same as outer `id`). - `sp_popularity` integer, nullable: Spotify popularity score (0–100). - `num_sp_playlists` integer, nullable: Number of Spotify playlists featuring this track. - `num_sp_editorial_playlists` integer, nullable: Number of Spotify editorial playlists featuring this track. - `num_am_playlists` integer, nullable: Number of Apple Music playlists featuring this track. - `num_am_editorial_playlists` integer, nullable: Number of Apple Music editorial playlists featuring this track. - `num_de_playlists` integer, nullable: Number of Deezer playlists featuring this track. - `num_de_editorial_playlists` integer, nullable: Number of Deezer editorial playlists featuring this track. - `num_az_playlists` integer, nullable: Number of Amazon playlists featuring this track. - `num_az_editorial_playlists` integer, nullable: Number of Amazon editorial playlists featuring this track. - `num_yt_playlists` integer, nullable: Number of YouTube playlists featuring this track. - `num_yt_editorial_playlists` integer, nullable: Number of YouTube editorial playlists featuring this track. - `num_tt_videos` integer, nullable: TikTok video count using this track. - `sp_playlist_total_reach` union: Sum of followers across all Spotify playlists featuring the track. Surfaces as string from PG uncast aggregate. - number, float - string - `sp_editorial_playlist_total_reach` union: Sum of followers across Spotify editorial playlists featuring the track. - number, float - string - `de_playlist_total_reach` union: Sum of fans across all Deezer playlists featuring the track. - number, float - string - `de_editorial_playlist_total_reach` union: Sum of fans across Deezer editorial playlists featuring the track. - number, float - string - `yt_playlist_total_reach` union: Sum of views across all YouTube playlists featuring the track. - number, float - string - `yt_editorial_playlist_total_reach` union: Sum of views across YouTube editorial playlists featuring the track. - number, float - string - `sp_streams` union: Total Spotify stream count. May exceed int32 and arrive as string. - number, float - string - `youtube_views` union: Total YouTube view count. May exceed int32 and arrive as string. - number, float - string - `soundcloud_playback_count` union: Total SoundCloud playback count. - number, float - string - `genius_page_views` integer, nullable: Genius lyrics page view count. - `shazam_counts` integer, nullable: Total Shazam tag count. - `tiktok_counts` integer, nullable: TikTok counter (legacy — alias of `num_tt_videos`). - `tiktok_trending_user` string, nullable: TikTok trending user ID for the track. - `tiktok_trending_user_likes` string, nullable: TikTok trending user like count. - `tiktok_trending_user_cm_artist` integer, nullable: Chartmetric artist ID of the TikTok trending user. - `pandora_lifetime_streams` integer, nullable: Pandora lifetime stream count. - `pandora_lifetime_stations_added` integer, nullable: Pandora lifetime stations-added count. - `boomplay_comments` string, nullable: Boomplay comment count. - `boomplay_favorites` string, nullable: Boomplay favorite count. - `boomplay_shares` string, nullable: Boomplay share count. - `line_music_likes` string, nullable: Line Music like count. - `line_music_listen_count` string, nullable: Line Music listen count. - `melon_likes` string, nullable: Melon like count. --- [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)