Chartmetric CLI

A command line tool for accessing the Chartmetric API.

cm tracks list

Lookup a list of tracks based on various params.

Synopsis

Full API endpoint documentation at https://api.chartmetric.com/apidoc/#api-Track-TrackList

cm tracks list [flags]

Examples

  cm tracks list --genres=462882,462884
  cm tracks list --artists=1054,72449,2762

Options

      --sortColumn string                         Sort results by a specific metric (see API documentation for full list)
      --sortOrderDesc string                      If true, sort results in descending order. Allowed values: 'true', 'false' (default: 'true')
                                                  
                                                  
      --limit string                              Maximum number of results to be returned
      --offset string                             Offset of entries to be returned
      --range_period string                       Filter by a specific stat's range period. Allowed values: 'latest', 'monthly_diff', 'weekly_diff'
      --max_score string                          Filter by maximum Chartmetric track score
      --min_score string                          Filter by minimum Chartmetric track score
      --max_release_date string                   Filter by maximum release date in ISO date format YYYY-MM-DD
      --min_release_date string                   Filter by minimum release date in ISO date format YYYY-MM-DD
      --max_airplay_streams string                Filter by maximum Airplay streams. The 'range_period' flag applies here.
      --min_airplay_streams string                Filter by minimum Airplay streams. The 'range_period' flag applies here.
      --max_amazon_playlist_count string          Filter by maximum Amazon Music playlist count. The 'range_period' flag applies here.
      --min_amazon_playlist_count string          Filter by minimum Amazon Music playlist count. The 'range_period' flag applies here.
      --max_deezer_playlist_count string          Filter by maximum Deezer playlist count. The 'range_period' flag applies here.
      --min_deezer_playlist_count string          Filter by minimum Deezer playlist count. The 'range_period' flag applies here.
      --max_itunes_playlist_count string          Filter by maximum iTunes playlist count. The 'range_period' flag applies here.
      --min_itunes_playlist_count string          Filter by minimum iTunes playlist count. The 'range_period' flag applies here.
      --max_shazam_count string                   Filter by maximum Shazam count. The 'range_period' flag applies here.
      --min_shazam_count string                   Filter by minimum Shazam count. The 'range_period' flag applies here.
      --max_siriusxm_streams string               Filter by maximum SiriusXM streams. The 'range_period' flag applies here.
      --min_siriusxm_streams string               Filter by minimum SiriusXM streams. The 'range_period' flag applies here.
      --max_soundcloud_plays string               Filter by maximum SoundCloud plays. The 'range_period' flag applies here.
      --min_soundcloud_plays string               Filter by minimum SoundCloud plays. The 'range_period' flag applies here.
      --max_spotify_playlist_count string         Filter by maximum Spotify playlist count. The 'range_period' flag applies here.
      --min_spotify_playlist_count string         Filter by minimum Spotify playlist count. The 'range_period' flag applies here.
      --max_spotify_playlist_total_reach string   Filter by maximum Spotify playlist reach. The 'range_period' flag applies here.
      --min_spotify_playlist_total_reach string   Filter by minimum Spotify playlist reach. The 'range_period' flag applies here.
      --max_spotify_plays string                  Filter by maximum Spotify plays. The 'range_period' flag applies here.
      --min_spotify_plays string                  Filter by minimum Spotify plays. The 'range_period' flag applies here.
      --max_spotify_popularity string             Filter by maximum Spotify popularity. The 'range_period' flag applies here.
      --min_spotify_popularity string             Filter by minimum Spotify popularity. The 'range_period' flag applies here.
      --max_tidal_popularity string               Filter by maximum Tidal popularity. The 'range_period' flag applies here.
      --min_tidal_popularity string               Filter by minimum Tidal popularity. The 'range_period' flag applies here.
      --max_tiktok_posts string                   Filter by maximum TikTok posts. The 'range_period' flag applies here.
      --min_tiktok_posts string                   Filter by minimum TikTok posts. The 'range_period' flag applies here.
      --max_tiktok_top_videos_likes string        Filter by maximum TikTok top video likes. The 'range_period' flag applies here.
      --min_tiktok_top_videos_likes string        Filter by minimum TikTok top video likes. The 'range_period' flag applies here.
      --max_tiktok_top_videos_views string        Filter by maximum TikTok top video views. The 'range_period' flag applies here.
      --min_tiktok_top_videos_views string        Filter by minimum TikTok top video views. The 'range_period' flag applies here.
      --max_youtube_likes string                  Filter by maximum YouTube video likes. The 'range_period' flag applies here.
      --min_youtube_likes string                  Filter by minimum YouTube video likes. The 'range_period' flag applies here.
      --max_youtube_playlist_count string         Filter by maximum YouTube playlist count. The 'range_period' flag applies here.
      --min_youtube_playlist_count string         Filter by minimum YouTube playlist count. The 'range_period' flag applies here.
                                                  
                                                  
      --genres string                             Filter by a comma-separated list of Chartmetric genre IDs
      --artists string                            Filter by a comma-separated list of Chartmetric artist IDs
      --shortlists string                         Filter by a comma-separated list of Chartmetric shortlist IDs
  -h, --help                                      help for list

Options inherited from parent commands

  -d, --debug                  Display debug output in the console (default: false)
  -r, --refresh_token string   Chartmetric API Refresh Token to use (overrides config file token; does not save)
  -V, --verbose                Show additional details only when displaying debug info (default: false)

SEE ALSO

  • cm tracks - Lookup information related to tracks
Auto generated by spf13/cobra on 28-Aug-2024