News

​

Recent artist milestones formatted as news items. Each row carries a summaryTemplate (with :placeholder tokens) plus summaryData (token values) and metadata (entity ids for deep-linking). Items are selected from the last ARTIST_NEWS_DAYS_AGO days with importance stars >= ceil(weight/2). subType indicates the underlying event kind (album, track, chart, playlist, artist) — summaryData/metadata shapes vary accordingly (kept permissive).

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

    Integer numbers.

    • enum
      const:  
      1
      values
      • 1
Query Parameters
  • limit
    Type: integer
    max:  
    50

    Integer numbers.

  • weight
    Type: integer
    max:  
    10

    Integer numbers.

Responses
  • application/json
Request Example for get/api/artist/{id}/news
curl 'https://api.chartmetric.com/api/artist/2/news?limit=10&weight=5' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": [
    {
      "id": "1",
      "type": "artist",
      "subType": "playlist",
      "formattedDate": "2025-02-21",
      "imageUrl": "https://i.scdn.co/image/ab67616d0000b27317db30ce3f081d6818a8ad49",
      "summaryTemplate": ":trackName  added to Spotify :playlistName at position 1 with 17.2K followers.",
      "summaryData": {
        "playlistName": "BAD NIGHTAN",
        "trackName": "Run BTS"
      },
      "metadata": {
        "playlist_id": "16165930",
        "playlistUrlParam": "playlist/spotify?id=16165930",
        "cmTrackId": 83623672,
        "artistName": "BTS",
        "cmArtistId": 206557
      },
      "stars": 3
    }
  ]
}

Success