Get Spotify Fresh Finds Charts

​

Return tracks from the Spotify Fresh Finds charts for a given date. Useful for spotting new independent-artist material. Unlike the other Spotify endpoints, the response is a bare array under obj (the handler does NOT wrap in { length, data }).

Query Parameters
  • date
    Type: string Format: date-time

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

  • latest
    Type: boolean

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

  • limit
    Type: integer
    min:  
    1
    max:  
    200

    Maximum number of items to return per request.

  • offset
    Type: integer
    min:  
    0
    max:  
    10000

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

Responses
  • application/json
Request Example for get/api/charts/spotify/freshfind
curl https://api.chartmetric.com/api/charts/spotify/freshfind \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": [
    {
      "spotify_track_id": "6ocbgoVGwYJhOv1GgI9NsF",
      "rank": 1,
      "num_all_playlists": 3,
      "num_ff_playlists": 1,
      "fresh_finds_playlists_ids": [
        688460
      ],
      "fresh_finds_playlists": [
        "Fresh Finds"
      ],
      "name": "7 rings",
      "isrc": "USUM71900110",
      "image_url": "https://i.scdn.co/image/38205ab1",
      "cm_track": 22290726,
      "spotify_artist_names": [
        "Ariana Grande"
      ],
      "artists": {
        "id": 3963,
        "name": "Ariana Grande",
        "code2": "US",
        "image_url": "https://i.scdn.co/image/abcd",
        "career_health": "Superstar",
        "career_stage": "Mainstream",
        "network_strength": {
          "score": 0.87,
          "label": "Strong",
          "instagram_score": 0.92,
          "instagram_label": "Strong",
          "youtube_score": 0.81,
          "youtube_label": "Strong"
        }
      }
    }
  ]
}

Success