---
title: Get Catalog Search Results
framework: devicemanagement
role: symbol
role_heading: Web Service Endpoint
path: devicemanagement/get-catalog-search-results
---

# Get Catalog Search Results

Fetch metadata for apps, books, and subscriptions from the catalog by using a search term.

## URL

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

## Path Parameters

storefront: An iTunes Store territory that you specify with an ISO 3166 alpha-2 country code. The possible values are the id attributes of Storefrontobjects.

## Query Parameters

additionalPlatforms: Additional platforms the app supports that you want to get metadata for. extend: A list of attribute extensions to apply to resources in the response. These attributes are usually more expensive, so only extend them if absolutely necessary. Classifier (optional): A resource type to apply the parameter to, apps or books. filter: A filter to apply to the search results. Classifier (required): The filter type, targetPlatforms or genre. Possible values for targetPlatforms are the same as for the platform parameter, and the value for genre is a genre ID. l: The localization to use, which you specify with a language tag. The possible values are in the supportedLanguageTags array belonging to the Storefront object that storefront specifies. Otherwise, the default is defaultLanguageTag in Storefront. platform: The platform the user-facing app is running on. You use this to get apps metadata for the specified platform. term: The text for the search. types: The resource types to include in the search results. Possible values: apps, books

## 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 Example Request and Response

## Topics

### Responses

- [ResultsResponse](devicemanagement/resultsresponse.md)
- [UnauthorizedResponse](devicemanagement/unauthorizedresponse.md)
- [ErrorsResponse](devicemanagement/errorsresponse.md)

## See Also

### Retrieving app and book metadata

- [Get Metadata for Your Apps](devicemanagement/get-your-apps-metadata.md)
- [Get Metadata for Your Books](devicemanagement/get-your-books-metadata.md)
- [Get Metadata for a Catalog App](devicemanagement/get-v1-catalog-_storefront_-apps-_id_.md)
- [Get Metadata for Multiple Catalog Apps](devicemanagement/get-v1-catalog-_storefront_-apps.md)
- [Get Metadata for a Catalog Book](devicemanagement/get-v1-catalog-_storefront_-books-_id_.md)
- [Get Metadata for Multiple Catalog Books](devicemanagement/get-v1-catalog-_storefront_-books.md)