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.

KeywordPlanHistoricalMetrics

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

JSON representation
{
  "monthlySearchVolumes": [
    {
      object (MonthlySearchVolume)
    }
  ],
  "competition": enum (KeywordPlanCompetitionLevel),
  "avgMonthlySearches": string,
  "competitionIndex": string,
  "lowTopOfPageBidMicros": string,
  "highTopOfPageBidMicros": string
}
Fields
monthlySearchVolumes[]

object (MonthlySearchVolume)

Approximate number of searches on this query for the past twelve months.

competition

enum (KeywordPlanCompetitionLevel)

The competition level for the query.

avgMonthlySearches

string (int64 format)

Approximate number of monthly searches on this query averaged for the past 12 months.

competitionIndex

string (int64 format)

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.

lowTopOfPageBidMicros

string (int64 format)

Top of page bid low range (20th percentile) in micros for the keyword.

highTopOfPageBidMicros

string (int64 format)

Top of page bid high range (80th percentile) in micros for the keyword.

MonthlySearchVolume

Monthly search volume.

JSON representation
{
  "month": enum (MonthOfYear),
  "year": string,
  "monthlySearches": string
}
Fields
month

enum (MonthOfYear)

The month of the search volume.

year

string (int64 format)

The year of the search volume (e.g. 2020).

monthlySearches

string (int64 format)

Approximate number of searches for the month. A null value indicates the search volume is unavailable for that month.

KeywordPlanCompetitionLevel

Competition level of a keyword.

Enums
UNSPECIFIED Not specified.
UNKNOWN The value is unknown in this version.
LOW Low competition. The Competition Index range for this is [0, 33].
MEDIUM Medium competition. The Competition Index range for this is [34, 66].
HIGH High competition. The Competition Index range for this is [67, 100].