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

# SearchTermPopularityTimeRange

Time range for search term popularity queries.

## Declaration

```data
object SearchTermPopularityTimeRange
```

## Properties

start: The start date of the range, in YYYY-MM-DD format. end: The end date of the range, in YYYY-MM-DD format. timeZone: Timezone. Fixed to UTC. Not user-configurable. Default: "UTC". granularity: Aggregation period. WEEKLY_SUN_SAT uses fixed Sunday–Saturday weeks and is generated Mondays at 07:00 UTC for the preceding Sunday through Saturday week, with a rolling retention of 65 weeks. MONTHLY uses calendar months and is refreshed on the 5th of each month UTC for the prior calendar month, with a rolling retention of 15 months. Possible values: WEEKLY_SUN_SAT, MONTHLY.

## Discussion

Discussion The SearchTermPopularityTimeRange object specifies the date window and granularity for a search term popularity report. Date format and retention period differ by granularity. note: Note: For MONTHLY granularity, the response truncates the date field to YYYY-MM. Example {   "start": "2025-01-01",   "end": "2025-03-31",   "timeZone": "UTC",   "granularity": "MONTHLY" }

## See Also

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