Get Spotify Track Charts

​

Return tracks charting on Spotify (Top 50, Viral 50, regional, or official-country charts) for a given date/interval. Each entry combines the chart row (rank, peak_rank, rankStats, etc.) with the track basic info (artists, albums, cross-platform IDs). current_plays and rankStats.plays are deprecated after 2022-06-02 and will be null for later rows.

Query Parameters
  • country_code
    Type: string
    min length:  
    2
    max length:  
    6
    required

    ISO 3166-1 alpha-2 country code (e.g. 'US', 'BR') or 'GLOBAL' for the global chart.

  • interval
    Type: string
    required

    Chart interval (e.g. daily, weekly).

  • type
    Type: string enum
    required

    Spotify track chart type (e.g. regional, top200, viral50, daily_top_tracks, weekly_top_tracks).

    values
    • plays
    • popularity
    • playlist_count
    • playlist_reach
    • viral
    • regional
  • date
    Type: string Format: date-time

    Date for the time-slice (YYYY-MM-DD). Required unless latest=true.

  • offset
    Type: integer
    min:  
    0

    Number of items to skip from the start of the result set; pair with limit to paginate.

  • latest
    Type: boolean

    If true, use the most recently available date and ignore date.

Responses
  • application/json
Request Example for get/api/charts/spotify
curl 'https://api.chartmetric.com/api/charts/spotify?country_code=&interval=&type=plays' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": {
    "length": 1,
    "data": [
      {
        "id": 4445159,
        "name": "What Ifs (feat. Lauren Alaina)",
        "isrc": "USRN11600859",
        "image_url": "https://i.scdn.co/image/3c29df3f40b15",
        "cm_track": 15711334,
        "rank": 1,
        "pre_rank": 2,
        "peak_rank": 1,
        "peak_date": "2020-06-01T00:00:00.000Z",
        "added_at": "2020-06-01T00:00:00.000Z",
        "chart_type": "regional",
        "chart_name": "Top Tracks",
        "code2": "US",
        "current_plays": 1084704,
        "time_on_chart": "3 days",
        "spotify": 1,
        "velocity": 0.25,
        "rankStats": [
          {
            "rank": 1,
            "timestp": "2020-06-01T00:00:00.000Z",
            "plays": 1084704
          }
        ],
        "spotify_artist_names": [
          "Kane Brown",
          "Lauren Alaina"
        ],
        "track_genre": "contemporary country,country"
      }
    ]
  }
}

Success