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 90 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

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

Query Parameters

limit
Type: integer
max:
50

Maximum number of news items to return. Defaults to 10, max 50.
weight
Type: integer
max:
10

Minimum milestone weight (2 weights = 1 star; items with stars >= ceil(weight/2) are included). Defaults to 5, max 10.

Responses

application/json

get/api/artist/{id}/news

curl 'https://api.chartmetric.com/api/artist/2/news?limit=10&weight=5' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Show Schema

{
  "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

Live Events

Venues