Airplay Track Charts

​

ACR airplay track charts. Handler builds the SQL table name from duration (acr_daily_track_chart / acr_weekly_track_chart) and optional cityId variant. Merges cross-platform track metadata and batched historical rankStats from QUERY_GET_TRACK_RANKINGS.ACR_BATCH.

Query Parameters
  • date
    Type: string Format: date-time

    Charting date (YYYY-MM-DD). Defaults to the latest available chart when omitted.

  • since
    Type: string Format: date-time

    Lower bound of the date range (YYYY-MM-DD). Required unless latest=true.

  • limit
    Type: integer

    Maximum entries returned per request (max 500).

  • duration
    Type: string enum
    required

    Chart duration (e.g. daily, weekly, monthly).

    values
    • daily
    • weekly
    • monthly
    • semi-yearly
    • yearly
    • all_time
  • country_code
    Type: string enum

    Airplay country code; only the ACR-supported countries are accepted. Defaults to 'GLOBAL'.

    values
    • AF
    • NL
    • AN
    • AL
    • DZ
  • latest
    Type: boolean

    If true, use the most recently available date and ignore since.

Responses
  • application/json
Request Example for get/api/charts/airplay/tracks
curl 'https://api.chartmetric.com/api/charts/airplay/tracks?duration=daily' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": {
    "length": null,
    "data": [
      {
        "id": 0,
        "name": null,
        "isrc": null,
        "image_url": null,
        "description": null,
        "tags": null,
        "cm_track": null,
        "cm_artist": [
          null
        ],
        "artist_names": [
          null
        ],
        "code2s": [
          null
        ],
        "artist_images": [
          null
        ],
        "artist_covers": [
          null
        ],
        "spotify_track_ids": [
          null
        ],
        "spotify_album_ids": [
          null
        ],
        "spotify_duration_ms": null,
        "itunes_track_ids": [
          null
        ],
        "itunes_album_ids": [
          null
        ],
        "itunes_artist_ids": [
          1
        ],
        "itunes_artist_names": [
          null
        ],
        "storefronts": [
          null
        ],
        "deezer_track_ids": [
          null
        ],
        "deezer_album_ids": [
          1
        ],
        "deezer_duration": null,
        "amazon_track_ids": [
          null
        ],
        "amazon_album_ids": [
          null
        ],
        "album_ids": [
          0
        ],
        "album_names": [
          null
        ],
        "album_upc": [
          null
        ],
        "album_label": [
          null
        ],
        "release_dates": [
          "2026-07-20T17:45:03.249Z"
        ],
        "created_at": "2026-07-20T17:45:03.249Z",
        "modified_at": "2026-07-20T17:45:03.249Z",
        "rank": null,
        "pre_rank": null,
        "peak_rank": null,
        "peak_date": "2026-07-20T17:45:03.249Z",
        "added_at": "2026-07-20T17:45:03.249Z",
        "velocity": null,
        "time_on_chart": "string",
        "code2": null,
        "city_id": null,
        "plays": 1,
        "count": 1,
        "weekly_count": 1,
        "rankStats": [
          {
            "rank": null,
            "plays": 1,
            "timestp": "2026-07-20T17:45:03.249Z"
          }
        ]
      }
    ]
  }
}

Success