📈 Trends
Performance trends for albums, artists, and tracks.
Resource Overview
Trends are intended for analytics and reporting purposes, enabling clients to monitor content performance across multiple regions and platforms.
The Trends endpoints provide access to historical and aggregated streaming data for Albums, Artists, and Tracks. These endpoints allow clients to analyze performance metrics over time, filtered by various parameters such as DSP (digital service provider), country, and date ranges.
Get Album Trends
GET
/albums/{id}/trends
Read Only
GET /albums/{id}/trends?filter[date-from]=2025-03-01&include=country,dsp
Authorization: Bearer {token}
Accept: application/vnd.api+jsonSystem-Generated Attributes
| Field | Type | Description |
|---|---|---|
| album-id | integer | Unique album identifier |
| date | date | Date of the plays count |
| country-id | integer | Unique country identifier |
| dsp-id | integer | Unique dsp identifier |
| source | string | Indicates where the play originated from |
| plays | integer | Number of times the album was played. |
Query Parameters
Filtering
- •
filter[dsp]- Filter by Dsp ID - •
filter[country]- Filter by Country ID - •
filter[date-from]- Filter by date from - •
filter[date-to]- Filter by date to
Other Parameters
- •
include- Include related resources
Available: album, dsp, country - •
page[number]- Page number - •
page[size]- Results per page
Success Response
200 OK
{
"data": [
{
"type": "album-trends",
"attributes": {
"album-id": 2284,
"date": "2025-10-05",
"country-id": 220,
"dsp-id": 1,
"source": "Organic",
"plays": 54923
},
"relationships": {
"album": {
"data": {
"type": "albums",
"id": "2284"
}
},
"country": {
"data": {
"type": "countries",
"id": "220"
}
},
"dsp": {
"data": {
"type": "dsps",
"id": "1"
}
}
}
},
{
"type": "album-trends",
"attributes": {
"album-id": 2284,
"date": "2025-11-15",
"country-id": 220,
"dsp-id": 1,
"source": "Playlist",
"plays": 131164
},
"relationships": {
"album": {
"data": {
"type": "albums",
"id": "2284"
}
},
"country": {
"data": {
"type": "countries",
"id": "220"
}
},
"dsp": {
"data": {
"type": "dsps",
"id": "1"
}
}
}
}
],
"meta": {
"page": {
"currentPage": 1,
"from": 1,
"lastPage": 3,
"perPage": 2,
"to": 2,
"total": 5
}
}
}Get Artist Trends
GET
/artists/{id}/trends
Read Only
GET /artists/{id}/trends?filter[date-from]=2025-10-01&filter[country]=220
Authorization: Bearer {token}
Accept: application/vnd.api+jsonSystem-Generated Attributes
| Field | Type | Description |
|---|---|---|
| artist-id | integer | Unique artist identifier |
| date | date | Date of the plays count |
| country-id | integer | Unique country identifier |
| dsp-id | integer | Unique dsp identifier |
| source | string | Indicates where the play originated from |
| plays | integer | Number of times the album was played. |
Query Parameters
Filtering
- •
filter[dsp]- Filter by Dsp ID - •
filter[country]- Filter by Country ID - •
filter[date-from]- Filter by date from - •
filter[date-to]- Filter by date to
Other Parameters
- •
include- Include related resources
Available: artist, dsp, country - •
page[number]- Page number - •
page[size]- Results per page
Success Response
200 OK
{
"data": [
{
"type": "artist-trends",
"attributes": {
"artist-id": 9544,
"date": "2025-10-05",
"country-id": 220,
"dsp-id": 1,
"source": "Organic",
"plays": 54923
},
"relationships": {
"artist": {
"data": {
"type": "artists",
"id": "9544"
}
},
"country": {
"data": {
"type": "countries",
"id": "220"
}
},
"dsp": {
"data": {
"type": "dsps",
"id": "1"
}
}
}
},
{
"type": "artist-trends",
"attributes": {
"artist-id": 9544,
"date": "2025-11-15",
"country-id": 220,
"dsp-id": 1,
"source": "Playlist",
"plays": 131164
},
"relationships": {
"artist": {
"data": {
"type": "artists",
"id": "9544"
}
},
"country": {
"data": {
"type": "countries",
"id": "220"
}
},
"dsp": {
"data": {
"type": "dsps",
"id": "1"
}
}
}
}
],
"included": [],
"meta": {
"page": {
"currentPage": 1,
"from": 1,
"lastPage": 3,
"perPage": 2,
"to": 2,
"total": 5
}
}
}Get Track Trends
GET
/tracks/{id}/trends
Read Only
GET /tracks/{id}/trends?filter[date-from]=2025-09-01&include=country,dsp
Authorization: Bearer {token}
Accept: application/vnd.api+jsonSystem-Generated Attributes
| Field | Type | Description |
|---|---|---|
| track-id | integer | Unique track identifier |
| album-id | integer | Unique album identifier |
| date | date | Date of the plays count |
| country-id | integer | Unique country identifier |
| dsp-id | integer | Unique dsp identifier |
| source | string | Indicates where the play originated from |
| plays | integer | Number of times the album was played |
| played-percent | decimal | Average percentage of the track that was played |
Query Parameters
Filtering
- •
filter[album]- Filter by Album ID - •
filter[dsp]- Filter by Dsp ID - •
filter[country]- Filter by Country ID - •
filter[date-from]- Filter by date from - •
filter[date-to]- Filter by date to
Other Parameters
- •
include- Include related resources
Available: track, album, dsp, country - •
page[number]- Page number - •
page[size]- Results per page
Success Response
200 OK
{
"data": [
{
"type": "track-trends",
"attributes": {
"track-id": 10540,
"album-id": 2284,
"date": "2025-10-05",
"country-id": 220,
"dsp-id": 1,
"source": "Organic",
"plays": 54923,
"played-percent": 100
},
"relationships": {
"track": {
"data": {
"type": "tracks",
"id": "10540"
}
},
"album": {
"data": {
"type": "albums",
"id": "2284"
}
},
"country": {
"data": {
"type": "countries",
"id": "220"
}
},
"dsp": {
"data": {
"type": "dsps",
"id": "1"
}
}
}
},
{
"type": "track-trends",
"attributes": {
"track-id": 10540,
"album-id": 2284,
"date": "2025-11-15",
"country-id": 220,
"dsp-id": 1,
"source": "Playlist",
"plays": 6644,
"played-percent": 100
},
"relationships": {
"track": {
"data": {
"type": "tracks",
"id": "10540"
}
},
"album": {
"data": {
"type": "albums",
"id": "2284"
}
},
"country": {
"data": {
"type": "countries",
"id": "220"
}
},
"dsp": {
"data": {
"type": "dsps",
"id": "1"
}
}
}
}
],
"included": [],
"meta": {
"page": {
"currentPage": 1,
"from": 1,
"lastPage": 2,
"perPage": 2,
"to": 2,
"total": 4
}
}
}