Airplay information in Time Series

​

Time series of how many times an artist, album, or track played on the radio. air_date is returned as a UNIX-epoch-milliseconds timestamp.

Path Parameters

  • Chartmetric ID for the entity in :type (artist / album / track ID).

  • Entity kind that :id refers to (one of artist | album | track).

Query Parameters

  • Start date of the time series in ISO format (e.g. 2025-11-01); defaults to 180 days ago.

Responses

  • application/json
Request Example for get/api/radio/{type}/{id}/airplays
curl 'https://api.chartmetric.com/api/radio/artist/1/airplays?since=2026-04-19' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "obj": [
    {
      "air_date": 1665964800000,
      "spins": 6
    },
    {
      "air_date": 1666051200000,
      "spins": 7
    }
  ]
}