Career History

​

Historical career-stage snapshots for an artist (stage/stage_score + momentum/momentum_score per timestp, descending by date). Structure parallels career_status from the artist metadata endpoint. Data pre 2023-05-12 is only available with legacy=true; data after 2023-09-20 is only available with legacy=false. Legacy support ends 2023-10-18.

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'). When null, no lower bound is applied.

  • until
    Type: string Format: date

    End of the date range in ISO format (e.g. '2025-11-15'). When null, no upper bound is applied.

  • limit
    Type: integer
    min:  
    0

    Maximum number of career-history rows to return. Defaults to 10.

  • offset
    Type: integer

    Number of rows to skip from the start of the result set. Defaults to 0.

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

{
  "obj": [
    {
      "timestp": "2023-07-26",
      "stage": "superstar",
      "stage_score": 68,
      "momentum": "decline",
      "momentum_score": 100
    }
  ]
}

Success