Track

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.

get/api/track/{id}/milestones

Request

Path parameters

idinteger required

Chartmetric track ID.

Query parameters

limitinteger

Maximum number of milestones to return. Defaults to 100.

offsetinteger

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

stars[]integer[]

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

fromDaysAgointeger

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

sortColumn'date' | 'stars'

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

sortOrderDescboolean

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

platforms[]string[]

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

groupedboolean

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

Response

Success

Changes

No recorded changes to this operation across all 1 revision of this API.