Airplay Artist Charts

ACR airplay artist charts. Duration and optional cityId select the source acr_*_artist_*chart table. Merges Artist.getBasicInfoBatch(artistIds) plus batched historical rankStats from QUERY_GET_USER_RANKINGS.ACR_BATCH.

Query Parameters
  • date
    Type: stringFormat: date-time

    the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

  • since
    Type: stringFormat: date-time

    the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

  • limit
    Type: integer

    Integer numbers.

  • duration
    Type: stringenum
    required
    values
    • daily
    • weekly
    • monthly
    • semi-yearly
    • yearly
    • all_time
  • country_code
    Type: stringenum
    values
    • AF
    • NL
    • AN
    • AL
    • DZ
  • latest
    Type: boolean
Responses
  • application/json
Request Example for get/api/charts/airplay/artists
curl 'https://api.chartmetric.com/api/charts/airplay/artists?date=&since=&limit=1&duration=daily&country_code=GLOBAL&latest=true' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "obj": {
    "length": null,
    "data": [
      {
        "rank": null,
        "pre_rank": null,
        "peak_rank": null,
        "peak_date": "2026-05-06T23:20:37.240Z",
        "added_at": "2026-05-06T23:20:37.240Z",
        "velocity": null,
        "time_on_chart": "string",
        "code2": null,
        "city_id": null,
        "plays": 1,
        "cm_artist": 0,
        "id": 0,
        "name": null,
        "image_url": null,
        "isni": null,
        "hometown_city": null,
        "current_city": null,
        "sp_followers": null,
        "sp_popularity": null,
        "sp_monthly_listeners": null,
        "deezer_fans": null,
        "tags": [],
        "spotify_artist_ids": [
          1
        ],
        "itunes_artist_ids": [
          1
        ],
        "deezer_artist_ids": [
          1
        ],
        "amazon_artist_ids": [
          1
        ],
        "cm_artist_rank": null,
        "rankStats": [
          {
            "rank": null,
            "plays": 1,
            "timestp": "2026-05-06T23:20:37.240Z"
          }
        ]
      }
    ]
  }
}