---
title: Get Catalog Charts
framework: Apple Music API
role: symbol
role_heading: Web Service Endpoint
platforms: [apple music 1.0+]
path: applemusicapi/charts
---

# Get Catalog Charts

Fetch one or more charts from the Apple Music Catalog.

## URL

GET https://api.music.apple.com/v1/catalog/{storefront}/charts

## Path Parameters

storefront: An iTunes Store territory, specified by an ISO 3166 alpha-2 country code. The possible values are the id attributes of Storefront objects.

## Query Parameters

types: A list of the types of charts to include in the results. The possible values are albums, songs, and music-videos. l: The localization to use, specified by a language tag. The possible values are in the supportedLanguageTags array belonging to the Storefront object specified by storefront. Otherwise, the default is defaultLanguageTag in Storefront. chart: The chart to fetch for the specified types. For possible values, get all the charts by sending this endpoint without the chart parameter. The possible values for this parameter are the chart attributes of the Chart objects in the response. genre: The identifier for the genre to use in the chart results. limit: The number of objects or number of objects in the specified relationship returned. offset: The next page or group of objects to fetch. with: The request modifiers for fetching non-standard charts collections. The value cityCharts fetches per-city charts. The value globalTopCharts allows the global charts to be fetched.

## Response Codes

200 OK: The request was successful. 401 Unauthorized: A response indicating an incorrect Authorization header. 500 Internal Server Error: A response indicating an error occurred on the server.

## Discussion

Discussion If successful, the HTTP status code is 200 (OK) and the response contains an object where results contains chart collections. The members for the collections are the chart types in the request and the values are Chart objects. The data member of each Chart object contains an array of the corresponding resource ordered by popularity. For example, if the request contains the songs chart type, the object contains a songs member with a value that is a Chart object containing Song objects. This may be a paginated response. For more information, see Fetch Resources by Page. If unsuccessful, the HTTP status code indicates the error and the details are in the errors array. For more information, see Handling Requests and Responses. Example

## See Also

### Related Documentation

- [ChartResponse](applemusicapi/chartresponse.md)