--- title: "Album Tracks" method: GET path: "/api/album/{id}/tracks" tags: ["Album"] --- # Album Tracks `GET /api/album/{id}/tracks` ## Request - Base URL: `https://api.chartmetric.com` - URL: `https://api.chartmetric.com/api/album/{id}/tracks` - Auth: HTTP bearer - TypeScript: (a function with typed inputs; its response is checked against the schema) Tracks on an album identified by Chartmetric ID. Each track carries cross-platform IDs, artist arrays, and a `cm_statistics` aggregate. Prefer `cm_artists[].{id,name,code2,image_url,cover_url}` over the parallel `cm_artist`, `artist_names`, `code2s`, `artist_images`, `artist_covers` arrays — those are retained for compatibility. ## Path parameters - `id` integer, required: Chartmetric album ID. ## Response `200` Success - object - `obj` object[], required - `id` integer, required: Chartmetric track ID. - `name` string, nullable: Track name. - `local_name` string, nullable: Localized track name, when available. - `local_name_locale` string, nullable: Locale for local_name, when available. - `image_url` string, nullable: Track cover image URL. - `isrc` string, nullable: International Standard Recording Code for the track. - `description` string, nullable: Track description. - `created_at` string, date-time, nullable: Date the track row was created in Chartmetric. - `modified_at` string, date-time, nullable: Date the track row was last modified in Chartmetric. - `tags` string, nullable: Comma-separated list of genres for the track. - `cm_track` integer, nullable: Chartmetric track ID. - `cm_artist` integer[], nullable: Chartmetric artist IDs. Index aligns with `artist_names`, `code2s`, `artist_images`, `artist_covers`. Prefer `cm_artists[].id`. - `artist_names` string[], nullable: Artist names. Deprecated; prefer `cm_artists[].name`. - `code2s` string[], nullable: Artist country codes (ISO 3166-1 alpha-2). Deprecated; prefer `cm_artists[].code2`. - `artist_images` string[], nullable: Artist image URLs. Deprecated; prefer `cm_artists[].image_url`. - `artist_covers` string[], nullable: Artist cover image URLs. Deprecated; prefer `cm_artists[].cover_url`. - `spotify_track_ids` string[], nullable: Spotify track IDs, sorted by popularity score. - `spotify_album_ids` string[], nullable: Spotify album IDs the track appears on. - `spotify_duration_ms` integer, nullable: Track duration on Spotify in milliseconds. - `itunes_track_ids` string[], nullable: iTunes track IDs. - `itunes_album_ids` string[], nullable: iTunes album IDs the track appears on. - `storefronts` string[], nullable: ISO 3166-1 alpha-2 codes for iTunes storefronts where the track is available. - `deezer_track_ids` string[], nullable: Deezer track IDs. - `deezer_album_ids` union[], nullable: Deezer album IDs the track appears on. - union - string - number, float - `deezer_duration` integer, nullable: Track duration on Deezer in seconds. - `amazon_track_ids` string[], nullable: Amazon track IDs. - `amazon_album_ids` string[], nullable: Amazon album IDs the track appears on. - `album_ids` integer[], nullable: Chartmetric album IDs the track appears on. Index aligns with `album_names`, `album_upc`, `album_label`, `release_dates`. - `album_names` string[], nullable: Album names. - `album_upc` string[], nullable: Album UPC codes. - `album_label` string[], nullable: Album record labels. - `release_dates` string[], nullable: Album release dates. - `cm_artists` object[], nullable: Artists credited on the track. - `name` string, nullable: Artist name. - `code2` string, nullable: Artist country code (ISO 3166-1 alpha-2, e.g. 'US'). - `image_url` string, nullable: Artist image URL. - `cover_url` string, nullable: Artist cover image URL. - `cm_statistics` object, nullable: Aggregated playlist counts and platform statistics for the track. - `num_sp_editorial_playlists` number, float, nullable: Count of Spotify editorial playlists featuring this track. - `num_sp_playlists` number, float, nullable: Count of Spotify playlists featuring this track. - `sp_playlist_total_reach` union: Sum of followers across all Spotify playlists featuring this track. Returned as a string when the value originates from Snowflake. - number, float - string - `num_am_editorial_playlists` number, float, nullable: Count of Apple Music editorial playlists featuring this track. - `num_am_playlists` number, float, nullable: Count of Apple Music playlists featuring this track. - `num_de_editorial_playlists` number, float, nullable: Count of Deezer editorial playlists featuring this track. - `num_de_playlists` number, float, nullable: Count of Deezer playlists featuring this track. - `de_playlist_total_reach` union: Sum of fans across all Deezer playlists featuring this track. Returned as a string when the value originates from Snowflake. - number, float - string - `num_az_editorial_playlists` number, float, nullable: Count of Amazon editorial playlists featuring this track. - `num_az_playlists` number, float, nullable: Count of Amazon playlists featuring this track. - `num_yt_editorial_playlists` number, float, nullable: Count of YouTube editorial playlists featuring this track. - `num_yt_playlists` number, float, nullable: Count of YouTube playlists featuring this track. - `yt_playlist_total_reach` union: Sum of subscribers across all YouTube playlists featuring this track. Returned as a string when the value originates from Snowflake. - number, float - string - `cm_track` integer, nullable: Chartmetric track ID. - `sp_popularity` integer, nullable: Spotify popularity score (0–100). - `num_tt_videos` integer, nullable: Count of TikTok videos using this track. - `genius_page_views` number, float, nullable: Total Genius lyrics page views for the track. - `shazam_counts` number, float, nullable: Total Shazam recognitions for the track. - `tiktok_counts` number, float, nullable: Total TikTok plays for the track. - `youtube_views` union: Total YouTube views for the track. Returned as a string when the value originates from Snowflake. - number, float - string --- [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)