KeywordPlanHistoricalMetrics

  • The data provided includes historical metrics for selected targeting options such as geographies and networks.

  • Key metrics available are monthly and average monthly search volumes, competition levels and indexes, and various bid and CPC data points.

  • Competition index reflects ad placement competitiveness for a keyword based on filled versus available ad slots.

  • Bid data includes low and high ranges for top of page bids, and there is also average Cost Per Click information.

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.