Noteworthy Insights

​

Recent noteworthy-insight rows for an artist — statistical outliers detected by the internal insights pipeline (daily or weekly). Each row includes a variant tier (very-low/low/high/very-high, or negative-positive for weekly negative→positive swings), the observed metric and its Dx1/Dx2 deltas, plus hydrated targetName/targetImageUrl/code2 from cm_artist_cache.

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
  • limit
    Type: integer
    min:  
    1

    Maximum number of insights to return. Defaults to 5.

  • fromDaysAgo
    Type: integer
    min:  
    1

    Restrict to insights from the last N days, counted from today. Defaults to 28, min 1.

  • insightType
    Type: string enum

    Insight cadence. One of daily, weekly. Defaults to daily.

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

{
  "obj": [
    {
      "variant": "very-low",
      "insightType": "daily",
      "metricName": "sp_followers",
      "insightId": 6765723,
      "target": "cm_artist",
      "targetId": "5596",
      "targetName": "Billie Eilish",
      "targetImageUrl": "https://i.scdn.co/image/ab67616100005174d8b9980db67272cb4d2c3daf",
      "insightDate": "2024-10-19T07:00:00.000Z",
      "insightDateMinus7Days": "2024-10-12T00:00:00.000Z",
      "graphImageUrl": "https://chartmetric-public.s3.us-west-2.amazonaws.com/noteworthy_insights/daily/dashboard/2024-10-19/cm_artist/5596/sp_followers.jpeg",
      "metricDx1": 93203,
      "metricDx2": 0.9780343385895287
    }
  ]
}

Success