---
title: "Get Apple Music Video Charts"
method: GET
path: "/api/charts/applemusic/videos"
tags: ["Charts"]
---

# Get Apple Music Video Charts

`GET /api/charts/applemusic/videos`

## Request

- Base URL: `https://api.chartmetric.com`
- URL: `https://api.chartmetric.com/api/charts/applemusic/videos`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/docs/api/charts/applemusic/videos/get.ts> (a function with typed inputs; its response is checked against the schema)

Return music videos charting on Apple Music for a given date. Shape mirrors the Apple Music track chart but entries reference video IDs. Many legacy fields overlap with the track endpoint.

## Query parameters

- `genre` string: Chart genre filter. Defaults to the un-segmented 'All Genres' chart when omitted.
- `country_code` string, required: ISO 3166-1 alpha-2 country code (2 letters, e.g. 'US', 'BR', 'GB').
- `date` string, date-time: Date for the time-slice (YYYY-MM-DD). Required unless `latest=true`.
- `offset` integer: Number of items to skip from the start of the result set; pair with `limit` to paginate.
- `latest` boolean: If true, use the most recently available date and ignore `date`.

## Response `200`

Success

- object
  - `obj` object
    - `length` integer, required: Number of chart rows in `data`.
    - `data` object[], required: Chart rows ordered by rank (1 = highest).
      - `rank` integer, nullable: Current chart position (1 = top).
      - `pre_rank` integer, nullable: Position on the previous chart period.
      - `peak_rank` integer, nullable: Best (lowest-numbered) rank reached on this chart.
      - `peak_date` string, date-time, nullable: Date when `peak_rank` was achieved.
      - `rank_1d_change` integer, nullable: Rank change vs 1 day ago (negative = moved up).
      - `rank_7d_change` integer, nullable: Rank change vs 7 days ago (negative = moved up).
      - `chart_name` string, nullable: Human-readable chart name.
      - `chart_type` string, nullable: Chart variant (e.g. `regional`, `top`, `viral`).
      - `code2` string, nullable: Chart country code (ISO 3166-1 alpha-2, or platform-specific value).
      - `timestp` string, date-time, nullable: Timestamp of the chart row.
      - `duration` string, nullable: Chart duration window (e.g. `daily`, `weekly`, `monthly`).
      - `added_at` string, date-time, nullable: Timestamp the row was inserted into the chart cache.
      - `velocity` number, float, nullable: Rank-velocity signal computed from rank deltas (positive = climbing).
      - `time_on_chart` union: Length of time on the chart. Legacy SQL emits a duration string (e.g. `"3 days"`); CCC emits an integer count of periods.
        - string
        - number, float
      - `country` string, nullable: Full country name corresponding to `code2`.
      - `genre` string, nullable: Chart genre.
      - `spotify` integer, nullable: Internal Spotify chart row ID.
      - `itunes` integer, nullable: Internal iTunes chart row ID.
      - `current_plays` integer, nullable: Stream count at chart time. Stale on Spotify charts after 2022-06-02 and may be null for later rows.
      - `rankStats` object[], nullable: Per-row historical rank samples.
        - `timestp` string, date-time, nullable: Timestamp at which the rank was recorded.
        - `rank` integer, nullable: Rank at `timestp` (1 = top).
      - `id` integer, nullable: Platform-specific row ID echoed back by the chart query (legacy).
      - `name` string, nullable: Track name.
      - `isrc` string, nullable: International Standard Recording Code.
      - `image_url` string, nullable: Track or album cover image URL.
      - `cm_track` integer, nullable: Chartmetric track ID.
      - `track_genre` union: Track genre(s) — string or array of strings depending on the source.
        - string
        - unknown[]
          - unknown
      - `spotify_popularity` integer, nullable: Spotify popularity score (0–100).
      - `spotify_duration_ms` integer, nullable: Track duration on Spotify in milliseconds.
      - `spotify_album_id` string, nullable: Spotify album ID associated with the track.
      - `composer_name` string, nullable: Composer name(s).
      - `cm_artist` integer[], nullable: Chartmetric artist IDs of the track artists.
      - `artist_names` string[], nullable: Track artist names.
      - `code2s` string[], nullable: ISO 3166-1 alpha-2 country codes per artist.
      - `artist_images` string[], nullable: Artist profile image URLs.
      - `artist_covers` string[], nullable: Artist cover image URLs.
      - `spotify_artist_ids` union[], nullable: Spotify artist IDs of the track artists.
        - union
          - integer
          - string
      - `spotify_artist_names` string[], nullable: Spotify artist names.
      - `spotify_track_ids` string[], nullable: Spotify track IDs.
      - `spotify_album_ids` string[], nullable: Spotify album IDs.
      - `itunes_artist_ids` union[], nullable: iTunes artist IDs.
        - union
          - integer
          - string
      - `itunes_artist_names` string[], nullable: iTunes artist names.
      - `itunes_track_ids` string[], nullable: iTunes track IDs.
      - `itunes_album_ids` string[], nullable: iTunes album IDs.
      - `storefronts` string[], nullable: Apple Music storefront codes (ISO 3166-1 alpha-2 lowercased) where the track is available.
      - `album_ids` integer[], nullable: Chartmetric album IDs of the album(s) containing this track.
      - `album_names` string[], nullable: Album names.
      - `album_upc` string[], nullable: Album UPC (Universal Product Code) values.
      - `album_label` string[], nullable: Record labels for the album(s).
      - `release_dates` string[], nullable: Album release dates.

---

[API](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api.md) - [All operations](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/revisions/94dac96833a3?raw)