<!--
{
  "availability" : [
    "VPP License Management: 2.2.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "DeviceManagement",
  "identifier" : "/documentation/DeviceManagement/Get-Catalog-Search-Results",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "Device Management"
    ],
    "preciseIdentifier" : "rest:vpp:get:v1-catalog-{}-search"
  },
  "title" : "Get Catalog Search Results"
}
-->

# Get Catalog Search Results

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

## Discussion

### Example Request and Response

**Request:**

```
?term=harry&platform=iphone&types=apps&filter[targetPlatform]=iphone,mac&filter[genre]=6014
```

**Response:**

```json
{
  "results": {
    "contents": [
      {
        "id": "623592465",
        "type": "apps",
        "href": "/v1/catalog/us/apps/623592465",
        "attributes": {
          "isVppDeviceBasedLicensingEnabled": true,
          "offers": [
            {
              "buyParams": "productType=C&price=1990&salableAdamId=623592465&pricingParameters=STDQ&pg=default&marketType=ENT&appExtVrsId=860907818",
              "type": "buy",
              "priceFormatted": "$1.99",
              "price": 1.99,
              "currencyCode": "USD",
              "assets": [
                {
                  "flavor": "iosSoftware",
                  "size": 207355904
                }
              ]
            }
          ],
          "isFirstPartyHideableApp": false,
          "contentRatingsBySystem": {
            "appsApple": {
              "name": "12+",
              "value": 300,
              "rank": 3,
              "advisories": [
                "Infrequent/Mild Alcohol, Tobacco, or Drug Use or References",
                "Infrequent/Mild Profanity or Crude Humor",
                "Infrequent/Mild Mature/Suggestive Themes"
              ]
            }
          },
          "deviceFamilies": [
            "iphone",
            "ipad",
            "ipod"
          ],
          "usesClassKit": false,
          "url": "https://apps.apple.com/us/app/heads-up/id623592465",
          "userRating": {
            "value": 4.9,
            "ratingCount": 1987
          },
          "isB2BCustomApp": false,
          "genreDisplayName": "Word",
          "name": "Heads Up!",
          "artistName": "Warner Bros.",
          "isIOSBinaryMacOSCompatible": false,
          "supportsDeviceSharing": false,
          "hasEula": false,
          "platformAttributes": {
            "ios": {
              "seller": "Warner Bros. Entertainment",
              "requiredCapabilitiesForRealityDevice": "arm64 gamekit metal ",
              "minimumMacOSVersion": "11.0",
              "minimumOSVersion": "13.0",
              "subtitle": "Play Charades with Friends!",
              "bundleId": "com.wb.Ellen.HeadsUp",
              "artwork": {
                "width": 1024,
                "height": 1024,
                "url": "https://isq11.mzstatic.com/image/thumb/Purple126/v4/71/b3/2a/71b32a24-34d2-7a89-ffba-8c252a140eb6/AppIconHalloween-0-0-1x_U007epad-0-85-220.png/{w}x{h}bb.{f}",
                "bgColor": "ffffff",
                "textColor1": "090000",
                "textColor2": "2e150b",
                "textColor3": "3a3333",
                "textColor4": "58443c"
              },
              "isVisionOSCompatible": false,
              "externalVersionId": 860907818,
              "minimumVisionOSVersion": "1.0",
              "requiredCapabilities": "arm64 gamekit metal "
            }
          }
        },
        "relationships": {
          "genres": {
            "href": "/v1/catalog/us/apps/623592465/genres",
            "data": [
              {
                "id": "6014",
                "type": "genres",
                "href": "/v1/catalog/us/genres/6014",
                "attributes": {
                  "parentName": "App Store",
                  "name": "Games",
                  "parentId": "36",
                  "url": "https://itunes.apple.com/us/genre/id6014"
                }
              },
              {
                "id": "6016",
                "type": "genres",
                "href": "/v1/catalog/us/genres/6016",
                "attributes": {
                  "parentName": "App Store",
                  "name": "Entertainment",
                  "parentId": "36",
                  "url": "https://itunes.apple.com/us/genre/id6016"
                }
              },
              {
                "id": "7019",
                "type": "genres",
                "href": "/v1/catalog/us/genres/7019",
                "attributes": {
                  "parentName": "Games",
                  "name": "Word",
                  "parentId": "6014",
                  "url": "https://itunes.apple.com/us/genre/id7019"
                }
              },
              {
                "id": "7005",
                "type": "genres",
                "href": "/v1/catalog/us/genres/7005",
                "attributes": {
                  "parentName": "Games",
                  "name": "Card",
                  "parentId": "6014",
                  "url": "https://itunes.apple.com/us/genre/id7005"
                }
              }
            ]
          }
        }
      }
    ]
  }
}
```

## Topics

### Responses

[`object ResultsResponse`](/documentation/DeviceManagement/ResultsResponse)

A response that contains the resource objects for the request.

[`object UnauthorizedResponse`](/documentation/DeviceManagement/UnauthorizedResponse)

A response that indicates an incorrect authorization header.

[`object ErrorsResponse`](/documentation/DeviceManagement/ErrorsResponse)

The collection of errors that occurred while processing the request.


---

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)