Total Airplays

Returns total airplay counts grouped by country, city, station, and track for the given artist, album, or track. Deprecated — prefer GET /api/radio/{type}/{id}/airplay-totals/{entity} for per-entity pagination.

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 for aggregating airplay totals in ISO format (e.g. 2025-11-01); defaults to 180 days ago.
station
Type: integer
min:
0
max:
2147483647

Chartmetric radio station ID; when set, narrows results to plays on this station only.
limit
Type: integer
min:
1
max:
100

Maximum entries returned per group (countries/cities/stations/tracks).

Responses

application/json

get/api/radio/{type}/{id}/airplay-totals

curl 'https://api.chartmetric.com/api/radio/artist/0/airplay-totals?since=2026-01-21' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Show Schema

{
  "obj": {
    "countries": [
      [
        {
          "code2": "US",
          "name": "United States",
          "plays": 76376,
          "plays_percent": 0.43664886744342934
        },
        [
          {
            "air_date": "2023-01-01T00:00:00.000Z",
            "count": 932
          },
          {
            "air_date": "2023-01-02T00:00:00.000Z",
            "count": 924
          }
        ]
      ]
    ],
    "cities": [
      [
        {
          "id": 2698,
          "name": "Berlin",
          "code2": "DE",
          "country": "Germany",
          "lat": 52.5218,
          "lng": 13.4015,
          "plays": 6168,
          "plays_percent": 0.03526304355283168
        },
        [
          {
            "air_date": "2023-01-01T00:00:00.000Z",
            "count": 89
          }
        ]
      ]
    ],
    "stations": [
      [
        {
          "id": 196100,
          "name": "ENERGY Romantic",
          "code2": "DE",
          "city": "Berlin",
          "country": "Germany",
          "plays": 1772,
          "plays_percent": 0.010130692797603393
        },
        [
          {
            "air_date": "2023-01-01T00:00:00.000Z",
            "count": 22
          }
        ]
      ]
    ],
    "tracks": [
      [
        {
          "id": 63926722,
          "name": "Easy On Me",
          "isrc": "USSM12105970",
          "plays": 44623,
          "plays_percent": 0.25511394170849677
        },
        [
          {
            "air_date": "2023-01-01T00:00:00.000Z",
            "count": 703
          }
        ]
      ]
    ]
  }
}

Success