---
title: Storefronts and Localization
framework: applemusicapi
role: collectionGroup
role_heading: API Collection
path: applemusicapi/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.

## Overview

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

## Topics

### Requesting a Catalog Storefront

- [Get a Storefront](applemusicapi/get-a-storefront.md)
- [Get Multiple Storefronts](applemusicapi/get-multiple-storefronts.md)
- [Get All Storefronts](applemusicapi/get-all-storefronts.md)

### Localization

- [Get the best supported language for a storefront](applemusicapi/get-the-best-supported-language-based-on-the-acceptlanguage.md)

### Handling the Response

- [Storefronts](applemusicapi/storefronts.md)

## See Also

### Essentials

- [Generating Developer Tokens](applemusicapi/generating-developer-tokens.md)
- [User Authentication for MusicKit](applemusicapi/user-authentication-for-musickit.md)
- [Handling Requests and Responses](applemusicapi/handling-requests-and-responses.md)
- [Handling Resource Representation and Relationships](applemusicapi/handling-resource-representation-and-relationships.md)
- [Common Objects](applemusicapi/common-objects.md)
- [Managing Content Ratings, Alternate Versions, and Equivalencies](applemusicapi/managing-content-ratings-alternate-versions-and-equivalencies.md)
- [Fetching Resources by Page](applemusicapi/fetching-resources-by-page.md)