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
  • id
    Type: integer
    min:  
    0
    max:  
    2147483647
    required

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

  • type
    Type: string enum
    required

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

    values
    • artist
    • track
    • album
Query Parameters
  • since
    Type: string Format: date
    required

    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/0/airplays?since=2026-01-21' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": [
    {
      "air_date": 1665964800000,
      "spins": 6
    },
    {
      "air_date": 1666051200000,
      "spins": 7
    }
  ]
}

Success