<!--
{
  "documentType" : "article",
  "framework" : "AppleMusicAPI",
  "identifier" : "/documentation/AppleMusicAPI/storefronts-and-localization",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Storefronts and Localization"
}
-->

# Storefronts and Localization

Pick a region-specific geographic location from which to retrieve catalog information, or retrieve information from the user’s personal library.

## Discussion

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.

```other
GET https://api.music.apple.com/v1/catalog/us/albums/310730204?l=es-MX
```

## Topics

### Requesting a Catalog Storefront

[`Get a Storefront`](/documentation/AppleMusicAPI/Get-a-Storefront)

Fetch a single storefront by using its identifier.

[`Get Multiple Storefronts`](/documentation/AppleMusicAPI/Get-Multiple-Storefronts)

Fetch one or more storefronts by using their identifiers.

[`Get All Storefronts`](/documentation/AppleMusicAPI/Get-All-Storefronts)

Fetch all the storefronts in alphabetical order.

### Localization

[`Get the best supported language for a storefront`](/documentation/AppleMusicAPI/Get-the-best-supported-language-based-on-the-acceptLanguage)

Fetch the best supported language for a storefront from a list.

### Handling the Response

[`object Storefronts`](/documentation/AppleMusicAPI/Storefronts)

A resource object that represents a storefront, an Apple Music and iTunes Store territory that the content is available in.



---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)