`google_ads_get_keyword_historical_metrics`

Get Google Ads Keyword Historical Metrics

Google

Description

Get historical search metrics for specific keywords — average monthly searches, competition level, and bid estimates. Unlike keyword ideas, this takes exact keywords you already have and returns their metrics. Use include_monthly_volumes=true for month-by-month search volume trends. Examples: check volume for ["running shoes", "trail running shoes"] before adding to campaigns, or validate keywords from external research.

Read-onlyIdempotentOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "google_ads_get_keyword_historical_metrics",
    "arguments": {
      "customer_id": "1234567890",
      "keywords": [
        "running shoes",
        "trail running shoes"
      ],
      "reason": "Check keyword search volume"
    }
  }
}

hopkin google keyword-historical-metrics get

Flag	Type	Required	Description
`--customer-id`	`string`	Required	The Google Ads Customer ID (10 digits, with or without dashes)
`--login-customer-id`	`string`	Optional	MCC (Manager) Customer ID; required for managed accounts
`--keywords`	`array`	Required	Keywords to get historical metrics for (1-200 keywords)
`--language`	`string`	Optional	ISO 639-1 language code (e.g. "en", "es"). Maps internally to languageConstants resource name.
`--geo-targets`	`array`	Optional	ISO 3166-1 alpha-2 country codes (e.g. ["US", "GB"]). Maps internally to geoTargetConstants.
`--network`	`string`	Optional	Network: GOOGLE_SEARCH (default) or GOOGLE_SEARCH_AND_PARTNERS
`--include-monthly-volumes`	`boolean`	Optional	When true, includes month-by-month search volume data. Default: false.

{
  "mcpServers": {
    "google-ads": {
      "url": "https://google.mcp.hopkin.ai",
      "transport": "sse"
    }
  }
}

Parameters

Name	Type	Required	Description
`customer_id`	`string`	Required	The Google Ads Customer ID (10 digits, with or without dashes)pattern: ^[\d-]+$
`keywords`	`array`	Required	Keywords to get historical metrics for (1-200 keywords)
`reason`	`string`	Required	Why this tool call is neededminLength: 1, maxLength: 500

Optional parameters (5)

Name	Type	Required	Description
`login_customer_id`	`string`	Optional	MCC (Manager) Customer ID; required for managed accountspattern: ^[\d-]+$
`language`	`string`	Optional	ISO 639-1 language code (e.g. "en", "es"). Maps internally to languageConstants resource name.pattern: ^[a-z]{2}$
`geo_targets`	`array`	Optional	ISO 3166-1 alpha-2 country codes (e.g. ["US", "GB"]). Maps internally to geoTargetConstants.
`network`	`string`	Optional	Network: GOOGLE_SEARCH (default) or GOOGLE_SEARCH_AND_PARTNERS `GOOGLE_SEARCH` `GOOGLE_SEARCH_AND_PARTNERS`
`include_monthly_volumes`	`boolean`	Optional	When true, includes month-by-month search volume data. Default: false.

Examples

Basic metrics

{
  "customer_id": "1234567890",
  "keywords": [
    "running shoes",
    "trail running shoes"
  ],
  "reason": "Check keyword search volume"
}

hopkin google keyword-historical-metrics get --customer-id 1234567890 --keywords running shoes,trail running shoes

With geo targeting

{
  "customer_id": "1234567890",
  "keywords": [
    "yoga classes"
  ],
  "geo_targets": [
    "US"
  ],
  "language": "en",
  "reason": "Market sizing for US"
}

hopkin google keyword-historical-metrics get --customer-id 1234567890 --keywords yoga classes --geo-targets US --language en

Monthly trends

{
  "customer_id": "1234567890",
  "keywords": [
    "winter coats"
  ],
  "include_monthly_volumes": true,
  "reason": "Analyze seasonal patterns"
}

hopkin google keyword-historical-metrics get --customer-id 1234567890 --keywords winter coats --include-monthly-volumes true