Caution: You are viewing documentation for the API's REST interface. Most of our official client libraries use gRPC. See the REST Introduction for details.
The year month range for historical metrics. If not specified, metrics for the past 12 months are returned. Search metrics are available for the past 4 years. If the search volume is not available for the entire yearMonthRange provided, the subset of the year month range for which search volume is available are returned.
YearMonthRange
The year month range inclusive of the start and end months. Eg: A year month range to represent Jan 2020 would be: (Jan 2020, Jan 2020).
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-03-06 UTC."],[[["Historical metrics options allow you to include average cost per click and specify a year-month range for data retrieval."],["The `YearMonthRange` object defines a range of months for historical metrics, including start and end points."],["`YearMonth` objects represent a specific month and year, allowing precise selection of historical data."],["By default, historical metrics for the past 12 months are returned, while search metrics are available for the past 4 years."],["If the specified `yearMonthRange` lacks complete search volume data, only the available subset will be returned."]]],["Historical metrics can be requested with options including `includeAverageCpc` (boolean) and `yearMonthRange` (object). `yearMonthRange` specifies a time frame with `start` and `end` `YearMonth` objects. Each `YearMonth` contains a `year` (string) and `month` (enum). If no `yearMonthRange` is provided, the last 12 months are used. Search metrics are available for up to four years, returning the available subset if the full range lacks data.\n"]]