---
title: Search for Catalog Resources
framework: Apple Music API
role: symbol
role_heading: Web Service Endpoint
platforms: [apple music 1.0+]
path: applemusicapi/search-for-catalog-resources-(by-type)
---

# Search for Catalog Resources

Search the catalog by using a query.

## URL

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

## 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

term: The entered text for the search with ‘+’ characters between each word, to replace spaces (for example term=james+br). 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. limit: The number of objects or number of objects in the specified relationship returned. offset: The next page or group of objects to fetch. types: The list of the types of resources to include in the results. with: A list of modifications to apply to the request.

## 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 results contains a map of search results. 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

- [SearchResponse](applemusicapi/searchresponse.md)

### Searching for Catalog Resources

- [Get Catalog Search Hints](applemusicapi/get-catalog-search-hints.md)
- [Get Catalog Search Suggestions](applemusicapi/get-catalog-search-suggesions.md)