`google_ads_get_keyword_performance`

Get Google Ads Keyword Performance

Google

Description

Get keyword-level performance metrics including quality score, match type, status, and search impression share. Supports segments parameter (e.g., ad_network_type) for channel-level breakdown — use to compare Search vs Search Partners per keyword. Includes a parallel conversion breakdown by ad group. Always fetches fresh data.

Read-onlyIdempotentOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "google_ads_get_keyword_performance",
    "arguments": {
      "customer_id": "1234567890",
      "date_preset": "LAST_7_DAYS",
      "reason": "Keyword performance review"
    }
  }
}

hopkin google keyword-performance 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
`--date-preset`	`string`	Optional	Predefined date range: TODAY, YESTERDAY, LAST_7_DAYS, LAST_30_DAYS, THIS_MONTH, LAST_MONTH
`--date-range`	`object`	Optional	Custom date range {start_date, end_date} in YYYY-MM-DD
`--campaign`	`string`	Optional	Filter to a specific campaign ID
`--ad-group-id`	`string`	Optional	Filter to a specific ad group ID
`--keyword-match-type`	`string`	Optional	Filter by match type: EXACT, PHRASE, BROAD
`--status`	`array`	Optional	Filter by keyword status: ENABLED, PAUSED, REMOVED
`--limit`	`integer`	Optional	Maximum number of rows to return (1-1000, default 100)
`--order-by`	`string`	Optional	Sort by metric (descending): impressions, clicks, cost, conversions, ctr
`--include-all-conversions`	`boolean`	Optional	When true, includes an additional all-conversions breakdown (metrics.all_conversions, all_conversions_value, value_per_all_conversions) segmented by conversion_action_name. This captures ALL conversion actions including those not marked "Include in Conversions".
`--segments`	`array`	Optional	Segments to break down by (e.g., ad_network_type, device). Use ad_network_type to split keyword metrics by channel (SEARCH vs SEARCH_PARTNERS).

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

Top keywords
Exact match only
Top converters
By network channel

Parameters

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

Optional parameters (11)

Name	Type	Required	Description
`login_customer_id`	`string`	Optional	MCC (Manager) Customer ID; required for managed accountspattern: ^[\d-]+$
`date_preset`	`string`	Optional	Predefined date range: TODAY, YESTERDAY, LAST_7_DAYS, LAST_30_DAYS, THIS_MONTH, LAST_MONTH `TODAY` `YESTERDAY` `LAST_7_DAYS` `LAST_30_DAYS` `THIS_MONTH` `LAST_MONTH`
`date_range`	`object`	Optional	Custom date range {start_date, end_date} in YYYY-MM-DD
`campaign_id`	`string`	Optional	Filter to a specific campaign IDpattern: ^\d+$
`ad_group_id`	`string`	Optional	Filter to a specific ad group IDpattern: ^\d+$
`keyword_match_type`	`string`	Optional	Filter by match type: EXACT, PHRASE, BROAD `EXACT` `PHRASE` `BROAD`
`status`	`array`	Optional	Filter by keyword status: ENABLED, PAUSED, REMOVED
`limit`	`integer`	Optional	Maximum number of rows to return (1-1000, default 100)min: 1, max: 1000
`order_by`	`string`	Optional	Sort by metric (descending): impressions, clicks, cost, conversions, ctr `impressions` `clicks` `cost` `conversions` `ctr`
`include_all_conversions`	`boolean`	Optional	When true, includes an additional all-conversions breakdown (metrics.all_conversions, all_conversions_value, value_per_all_conversions) segmented by conversion_action_name. This captures ALL conversion actions including those not marked "Include in Conversions".
`segments`	`array`	Optional	Segments to break down by (e.g., ad_network_type, device). Use ad_network_type to split keyword metrics by channel (SEARCH vs SEARCH_PARTNERS).

Examples

Top keywords

{
  "customer_id": "1234567890",
  "date_preset": "LAST_7_DAYS",
  "reason": "Keyword performance review"
}

hopkin google keyword-performance get --customer-id 1234567890 --date-preset LAST_7_DAYS

Exact match only

{
  "customer_id": "1234567890",
  "date_preset": "LAST_7_DAYS",
  "keyword_match_type": "EXACT",
  "reason": "Exact match keyword analysis"
}

hopkin google keyword-performance get --customer-id 1234567890 --date-preset LAST_7_DAYS --keyword-match-type EXACT

Top converters

{
  "customer_id": "1234567890",
  "date_preset": "LAST_30_DAYS",
  "order_by": "conversions",
  "status": [
    "ENABLED"
  ],
  "reason": "Find top converting keywords"
}

hopkin google keyword-performance get --customer-id 1234567890 --date-preset LAST_30_DAYS --order-by conversions --status ENABLED

By network channel

{
  "customer_id": "1234567890",
  "date_preset": "LAST_30_DAYS",
  "segments": [
    "ad_network_type"
  ],
  "reason": "Keyword performance by ad network"
}

hopkin google keyword-performance get --customer-id 1234567890 --date-preset LAST_30_DAYS --segments ad_network_type