---
title: RecommendationQueryRequest
framework: Apple Ads Platform API
role: symbol
role_heading: Object
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/recommendationqueryrequest
---

# RecommendationQueryRequest

The structured request body for all recommendation query endpoints.

## Declaration

```data
object RecommendationQueryRequest
```

## Properties

filters: Array of filter conditions. promotedObjectId and promotedObjectType filters are required on every request. See FilterCondition. sorting: Array of sort specifications. Multiple entries are applied in order (primary sort first). See Sorting. pagination: Pagination parameters controlling offset and page size. Defaults: offset 0, pageSize 20. See QueryRequestPagination.

## Discussion

Discussion The QueryRequest object is the request body for all POST .../query endpoints in the Recommendations API. Two filter conditions are mandatory on every request: [   {     "field": "promotedObjectId",     "operator": "EQUALS",     "value": [       "123456"     ]   },   {     "field": "promotedObjectType",     "operator": "EQUALS",     "value": [       "APPSTORE_APP"     ]   } ] Omitting either required filter returns a 400 error with a MISSING_REQUIRED_FILTER detail in the response. Additional optional filters narrow the result set. For example, state or campaignId. The API combines all filter conditions with AND logic. Example {   "filters": [     {       "field": "promotedObjectId",       "operator": "EQUALS",       "value": [         "123456789"       ]     },     {       "field": "promotedObjectType",       "operator": "EQUALS",       "value": [         "APPSTORE_APP"       ]     },     {       "field": "state",       "operator": "EQUALS",       "value": [         "AVAILABLE"       ],       "ignoreCase": false     }   ],   "sorting": [     {       "field": "creationTime",       "order": "DESC"     }   ],   "pagination": {     "offset": 0,     "pageSize": 20   } }

## See Also

- [QueryRequestPagination](apple-ads-platform-api/recommendationqueryrequestpagination.md)
- [Sorting](apple-ads-platform-api/recommendationsorting.md)
- [SortingOrder](apple-ads-platform-api/recommendationsortingorder.md)
- [FilterCondition](apple-ads-platform-api/recommendationfiltercondition.md)
- [FilterOperator](apple-ads-platform-api/recommendationfilteroperator.md)
- [RecommendationState](apple-ads-platform-api/recommendationstate.md)
- [RecommendationStatus](apple-ads-platform-api/recommendationstatus.md)
- [RecommendationCategory](apple-ads-platform-api/recommendationcategory.md)