To discuss and provide feedback on our products, join the official Google Ads Discord channel in the Google Advertising and Measurement Community server.

KeywordPlanHistoricalMetrics

Historical metrics specific to the targeting options selected. Targeting options include geographies, network, and so on. Refer to https://support.google.com/google-ads/answer/3022575 for more details.

Fields
`monthly_search_volumes[]`	`MonthlySearchVolume` Approximate number of searches on this query for the past twelve months.
`competition`	`KeywordPlanCompetitionLevel` The competition level for the query.
`avg_monthly_searches`	`int64` Approximate number of monthly searches on this query, averaged for the past 12 months.
`competition_index`	`int64` The competition index for the query in the range [0, 100]. Shows how competitive ad placement is for a keyword. The level of competition from 0-100 is determined by the number of ad slots filled divided by the total number of ad slots available. If not enough data is available, null is returned.
`low_top_of_page_bid_micros`	`int64` Top of page bid low range (20th percentile) in micros for the keyword.
`high_top_of_page_bid_micros`	`int64` Top of page bid high range (80th percentile) in micros for the keyword.
`average_cpc_micros`	`int64` Average Cost Per Click in micros for the keyword.

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-08-07 UTC.

KeywordPlanHistoricalMetrics Stay organized with collections Save and categorize content based on your preferences.