SearchTermPopularityTimeRange

Time range for search term popularity queries.

Declaration

object SearchTermPopularityTimeRange

Properties

Name	Type	Description
`start` Required	string	The start date of the range, in `YYYY-MM-DD` format.
`end` Required	string	The end date of the range, in `YYYY-MM-DD` format.
`timeZone`	string	Timezone. Fixed to `UTC`. Not user-configurable. Default: `"UTC"`.
`granularity` Required	string	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

The SearchTermPopularityTimeRange object specifies the date window and granularity for a search term popularity report. Date format and retention period differ by granularity.

Example

{
  "start": "2025-01-01",
  "end": "2025-03-31",
  "timeZone": "UTC",
  "granularity": "MONTHLY"
}