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: string enum
    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
Query Parameters
  • fromDaysAgo
    Type: integer
    required

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

  • chartEntity
    Type: string enum

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

    values
    • track
    • album
    • artist
    • video
  • chartType
    Type: string

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

  • duration
    Type: string enum

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

    values
    • daily
    • weekly
    • monthly
    • semi-yearly
    • yearly
    • all_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' \
  --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