Specifying a Date Range

  • AdSense report queries use a date_range field to specify the timeframe for included data, accepting values such as TODAY, YESTERDAY, or various relative ranges.

  • For custom date ranges, set date_range to CUSTOM and specify the inclusive start and end dates using start_date and end_date parameters.

  • Custom start and end dates are defined by separate parameters for year, month, and day, formatted like startDate.year=2021&startDate.month=3&startDate.day=1.

Relative date ranges

Report queries have a date_range field for specifying the dates for which to include data in the report. The following values can be specified for date_range:

  • TODAY
  • YESTERDAY
  • MONTH_TO_DATE
  • YEAR_TO_DATE
  • LAST_7_DAYS
  • LAST_30_DAYS
  • CUSTOM

Note that the default date range if none is specified is CUSTOM.

Custom date ranges

When date_range is set to CUSTOM or is unspecified, you must set start_date and end_date to the (inclusive) start and end dates of the report range.

In your API request's query parameters, the start date parameters will look like this:

startDate.year=2021&startDate.month=3&startDate.day=1

Similarly, the end date parameters will look like this:

endDate.year=2021&endDate.month=3&endDate.day=3

Next steps