List Milestones for a Track

​

Return milestone events (chart adds, playlist adds, threshold crossings, etc.) for a track, ranked by star count by default. Use grouped=true or group=<groupKey> to paginate within categories.

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

    Chartmetric track ID.

Query Parameters
  • limit
    Type: integer
    min:  
    1

    Maximum number of milestones to return. Defaults to 100.

  • offset
    Type: integer
    min:  
    0

    Number of items to skip from the start of the result set; pair with limit to paginate.

  • stars[]
    Type: array integer[]

    Restrict to milestones with star counts in this set (e.g. [1, 2, 3]). Each value is between 1 and 5.

  • fromDaysAgo
    Type: integer

    Restrict to milestones from the last N days, counted from today.

  • sortColumn
    Type: string enum

    Column to sort milestones by. One of date, stars. Defaults to date.

    values
    • date
    • stars
  • sortOrderDesc
    Type: boolean

    If true, sort descending by sortColumn. Defaults to true.

  • platforms[]
    Type: array string[] · Platform name[]enum

    Restrict to milestones from these platforms (e.g. Spotify, YouTube).

    values
    • amazon
    • apple_music
    • beatport
    • chartmetric
    • deezer
  • grouped
    Type: boolean

    If true, return only the top milestone per group (e.g. one per chart). Defaults to false.

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

{
  "obj": {
    "insights": [
      {
        "id": 1754976786,
        "date": "2024-04-29",
        "summary": "Run added to Spotify Top 50 - Vietnam at position 5 with 90.5K followers.",
        "artist_name": "BTS",
        "track_name": "Run",
        "platform": "Spotify",
        "stars": 4
      }
    ],
    "count": 14
  }
}

Success