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

# ImpressionShareQueryRequest

Request body for the impression share query endpoint.

## Declaration

```data
object ImpressionShareQueryRequest
```

## Properties

filters: Filter conditions. A filter on promotedObjectId is required. Omitting it will result in a 400 error. sorting: Sort criteria. Maximum 2 sort fields. timeRange: Specifies the date window to query. Timezone is fixed to UTC. See ImpressionShareTimeRange for details. pagination: Pagination controls. Default pageSize is 100. Maximum pageSize is 10000. See RequestPagination for details. options: Allows additional configuration of the impression share calculation. See ImpressionShareOptions for details.

## Example

Example {   "fields": [],   "filters": [     {       "field": "promotedObjectId",       "operator": "EQUALS",       "value": "123456789"     },     {       "field": "countryOrRegion",       "operator": "EQUALS",       "value": "US"     }   ],   "sorting": [     {       "field": "highImpressionShare",       "order": "DESC"     }   ],   "timeRange": {     "start": "2025-01-01",     "end": "2025-01-07",     "timeZone": "UTC",     "granularity": "DAILY"   },   "pagination": {     "offset": 0,     "pageSize": 20   },   "options": {     "impressionShareReportType": "FIRST_SLOT"   } }

## See Also

- [ImpressionShareQueryResponse](apple-ads-platform-api/impressionsharequeryresponse.md)
- [ImpressionShareRow](apple-ads-platform-api/impressionsharerow.md)
- [ImpressionShareTimeRange](apple-ads-platform-api/impressionsharetimerange.md)
- [ImpressionShareOptions](apple-ads-platform-api/impressionshareoptions.md)
- [SearchTermPopularityQueryRequest](apple-ads-platform-api/searchtermpopularityqueryrequest.md)
- [SearchTermPopularityQueryResponse](apple-ads-platform-api/searchtermpopularityqueryresponse.md)
- [SearchTermPopularityRow](apple-ads-platform-api/searchtermpopularityrow.md)
- [SearchTermPopularityTimeRange](apple-ads-platform-api/searchtermpopularitytimerange.md)
- [ImpressionShareResultContainer](apple-ads-platform-api/impressionshareresultcontainer.md)
- [SearchTermPopularityResultContainer](apple-ads-platform-api/searchtermpopularityresultcontainer.md)
- [KeywordInsights](apple-ads-platform-api/keywordinsights.md)
- [ReportingKeywordBidRecommendation](apple-ads-platform-api/reportingkeywordbidrecommendation.md)