Charts

Get Spotify Track Charts

Return tracks charting on Spotify (Top 50, Viral 50, regional, or official-country charts) for a given date/interval. Each entry combines the chart row (rank, peak_rank, rankStats, etc.) with the track basic info (artists, albums, cross-platform IDs). current_plays and rankStats.plays are deprecated after 2022-06-02 and will be null for later rows.

get/api/charts/spotify

Request

Query parameters

country_codestring required

ISO 3166-1 alpha-2 country code (e.g. 'US', 'BR') or 'GLOBAL' for the global chart.

intervalstring required

Chart interval (e.g. daily, weekly).

type'plays' | 'popularity' | 'playlist_count' | 'playlist_reach' | 'viral' | 'regional' required

Spotify track chart type (e.g. regional, top200, viral50, daily_top_tracks, weekly_top_tracks).

datestring date-time

Date for the time-slice (YYYY-MM-DD). Required unless latest=true.

offsetinteger

Number of items to skip from the start of the result set; pair with limit to paginate.

latestboolean

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

Response

Success

Changes

No recorded changes to this operation across all 1 revision of this API.