KeywordPlanHistoricalMetrics
Stay organized with collections
Save and categorize content based on your preferences.
| 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.
[null,null,["Last updated 2025-08-07 UTC."],[],[],null,["# KeywordPlanHistoricalMetrics\n\nHistorical metrics specific to the targeting options selected. Targeting options include geographies, network, and so on. Refer to \u003chttps://support.google.com/google-ads/answer/3022575\u003e for more details.\n\n| Fields ||\n|-----------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ### `monthly_search_volumes[]` | [MonthlySearchVolume](/google-ads/api/reference/rpc/v20/MonthlySearchVolume) Approximate number of searches on this query for the past twelve months. |\n| ### `competition` | [KeywordPlanCompetitionLevel](/google-ads/api/reference/rpc/v20/KeywordPlanCompetitionLevelEnum.KeywordPlanCompetitionLevel) The competition level for the query. |\n| ### `avg_monthly_searches` | `int64` Approximate number of monthly searches on this query, averaged for the past 12 months. |\n| ### `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. |\n| ### `low_top_of_page_bid_micros` | `int64` Top of page bid low range (20th percentile) in micros for the keyword. |\n| ### `high_top_of_page_bid_micros` | `int64` Top of page bid high range (80th percentile) in micros for the keyword. |\n| ### `average_cpc_micros` | `int64` Average Cost Per Click in micros for the keyword. |"]]
