Cross-Platform Performance (CPP)

​

Cross-Platform Performance rank or score time-series for the artist. stat=score returns { score, timestp } rows, stat=rank returns { rank, timestp }; when stat=rank is combined with latest=true, the response additionally carries rank_25_75. Values come from Snowflake and keys are lower-cased in the API layer.

Path Parameters
  • id
    Type: integer
    min:  
    2
    max:  
    2147483647
    required

    Chartmetric artist ID. Note: id=1 ('Various Artists') is rejected.

    • enum
      const:  
      1
      values
      • 1
Query Parameters
  • since
    Type: string Format: date

    Start of the date range in ISO format (e.g. '2025-11-01'). Defaults to 20 days ago. Ignored when latest=true.

  • until
    Type: string Format: date

    End of the date range in ISO format (e.g. '2025-11-01'). Defaults to today. Ignored when latest=true.

  • stat
    Type: string enum
    required

    CPP statistic to return. rank is the Chartmetric Cross-Platform Performance rank; score is the underlying 0–1 score from which the rank is derived.

    values
    • score
    • rank
  • latest
    Type: boolean

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

Responses
  • application/json
Request Example for get/api/artist/{id}/cpp
curl 'https://api.chartmetric.com/api/artist/2/cpp?stat=score' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": [
    {
      "score": 0.777289463353648,
      "timestp": "2019-12-10T00:00:00.000Z"
    },
    {
      "score": 0.812443293506014,
      "timestp": "2019-12-12T00:00:00.000Z"
    },
    {
      "score": 0.758845785647956,
      "timestp": "2019-12-13T00:00:00.000Z"
    }
  ]
}

Success