Storefronts and Localization
Pick a region-specific geographic location from which to retrieve catalog information, or retrieve information from the user’s personal library.
Overview
Apple Music is a worldwide service that operates in many countries, regions, and languages. Content varies from one geographic region to another, so each request must contain a storefront object. Storefront defines the desired region and the supported languages for that region. For most requests, you specify the storefront associated with the current user, but you may also specify other storefronts as needed. For example, you might specify a storefront that better matches the user’s preferred language.
Each storefront has a default language, and may support one or more additional languages. For example, the United States storefront includes American English as the default language, but also includes Mexican Spanish as an additional supported language. Apple Music automatically localizes responses using the storefront’s default language, but you can localize to a different language using the l query parameter. The value of that parameter must be one of the values in the supportedLanguageTags attribute of the storefront object. For example, the following request asks the US storefront to return an album in the Mexican Spanish (es-MX) localization.
GET https://api.music.apple.com/v1/catalog/us/albums/310730204?l=es-MX