List Chart Dates for Streaming Type

​

Return the dates with available chart data for the given streamingType. Source varies by platform: S3, Snowflake, ClickHouse, or RDS (see ChartFilterOptionsService.getChartDatesDataSource). Returns an array of { timestp } objects wrapped by handleDBResponse(res, "obj").

Path Parameters

  • streamingType
    Type: stringenum
    required

    Streaming type whose available chart dates are returned (e.g. spotify_track, spotify_artist, youtube, tiktok_top_tracks, melon_daily).

    values
    • acr_daily_artist
    • acr_weekly_artist
    • acr_daily_track
    • acr_weekly_track
    • amazon
    • amazon_albums
    • amazon_new_tracks
    • apple_music

Query Parameters

  • fromDaysAgo
    Type: integer
    required

    Look-back window in days; e.g. fromDaysAgo=9999 returns all available chart dates.

  • chartEntity
    Type: stringenum

    Chart entity (track or album). Required only for chart types that vary by entity.

    values
    trackalbumartistvideo
  • chartType
    Type: string

    Chart type within the streaming platform. Required only for some charts; see each chart endpoint for the valid values.

  • duration
    Type: stringenum

    Chart duration (e.g. daily, weekly, monthly, all_time). Required only for some charts.

    values
    dailyweeklymonthlysemi-yearlyyearlyall_time
  • country
    Type: string

    Country code (ISO 3166-1 alpha-2). Required only for some charts.

  • genre
    Type: string

    Chart genre. Required only for some charts.

Responses

  • application/json
Request Example for get/api/charts/{streamingType}/dates
curl 'https://api.chartmetric.com/api/charts/acr_daily_artist/dates?fromDaysAgo=1&chartEntity=track&duration=daily' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": [
    {
      "timestp": "2025-04-23T07:00:00.000Z"
    },
    {
      "timestp": "2025-04-13T07:00:00.000Z"
    },
    {
      "timestp": "2025-04-06T07:00:00.000Z"
    },
    {
      "timestp": "2025-03-30T07:00:00.000Z"
    }
  ]
}

Success

Previous
List Chart Countries for Platform
Next
List Chart Genres for Platform