Album Platform Stats

​

Time-series of a platform-specific stat for an album (currently platform=spotify, stat=followers returns Spotify popularity). Pass latest=true to bypass the date window and receive the most recent point.

Path Parameters
  • platform
    enum
    const:  
    spotify
    required

    Streaming platform whose stat is requested. Currently only spotify is supported.

    values
    • spotify
  • stats
    enum
    const:  
    followers
    required

    Platform stat to retrieve. Currently only followers is supported (returns Spotify popularity).

    values
    • followers
  • id
    Type: integer
    min:  
    0
    max:  
    2147483647
    required

    Chartmetric album ID.

Query Parameters
  • since
    Type: string Format: date

    Start of the date window in ISO format (e.g. '2025-11-01'). Defaults to 180 days ago.

  • until
    Type: string Format: date

    End of the date window in ISO format (e.g. '2025-11-15'). Defaults to today.

  • latest
    Type: boolean

    If true, returns only the most recent data point and ignores the since/until window.

Responses
  • application/json
Request Example for get/api/album/{id}/{platform}/{stats}
curl https://api.chartmetric.com/api/album/0/spotify/followers \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": [
    {
      "value": 97,
      "timestp": "2020-09-20T07:00:00.000Z"
    },
    {
      "value": 97,
      "timestp": "2020-09-21T07:00:00.000Z"
    },
    {
      "value": 97,
      "timestp": "2020-09-22T07:00:00.000Z"
    },
    {
      "value": 97,
      "timestp": "2020-09-23T07:00:00.000Z"
    }
  ]
}

Success