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

# ImpressionShareTimeRange

Time range for impression share queries.

## Declaration

```data
object ImpressionShareTimeRange
```

## Properties

start: Start date in YYYY-MM-DD format. When granularity is WEEKLY_SUN_SAT, this date must be a Sunday. end: End date in YYYY-MM-DD format. timeZone: Timezone. Fixed to UTC. Not user-configurable. Default: "UTC". granularity: Aggregation period. DAILY aggregates per day, with a maximum window of 30 days (inclusive), and populates the day field (not the week field) in each row. WEEKLY_SUN_SAT aggregates per Sunday-to-Saturday week, with a maximum window of 4 weeks, and populates the week field (not the day field) with the Sunday start date. The start date must be a Sunday. Possible values: DAILY, WEEKLY_SUN_SAT.

## Discussion

Discussion The ImpressionShareTimeRange object specifies the date window and granularity for an impression share report. Example {   "start": "2025-01-01",   "end": "2025-01-30",   "timeZone": "UTC",   "granularity": "DAILY" }

## See Also

- [ImpressionShareQueryRequest](apple-ads-platform-api/impressionsharequeryrequest.md)
- [ImpressionShareQueryResponse](apple-ads-platform-api/impressionsharequeryresponse.md)
- [ImpressionShareRow](apple-ads-platform-api/impressionsharerow.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)