Charts

Get iTunes Album Charts

Return albums charting on iTunes for a given date, filterable by country and genre. Entries carry album metadata + chart position + rankStats.

get/api/charts/itunes/albums

Request

Base URL
https://api.chartmetric.com
Auth
HTTP bearer
TypeScript
https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/docs/api/charts/itunes/albums/get.ts
A function with typed inputs. Its response is checked against the schema.

genrestring

Chart genre filter. Defaults to the un-segmented 'All Genres' chart when omitted.

country_codestring required

ISO 3166-1 alpha-2 country code (2 letters, e.g. 'US', 'BR', 'GB').

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.

Success

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