google_ads_get_search_terms_report

Description

Get actual search queries that triggered ads, with performance metrics and keyword match status. Google may not disclose all terms for privacy. Supports segments parameter (e.g., ad_network_type) for channel-level breakdown — use to compare Search vs Search Partners per search term. Always fetches fresh data. Conversion breakdown (keyed by search term) and landing page lookups are opt-in to control response size. Passing conversion_action_name in segments auto-enables conversion breakdown. If a breakdown query fails, that breakdown comes back empty and \

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "google_ads_get_search_terms_report",
    "arguments": {
      "customer_id": "1234567890",
      "date_preset": "LAST_7_DAYS",
      "reason": "Search term analysis"
    }
  }
}

hopkin google search-terms-report get

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

Parameters

Examples

{
  "customer_id": "1234567890",
  "date_preset": "LAST_7_DAYS",
  "reason": "Search term analysis"
}

{
  "customer_id": "1234567890",
  "date_preset": "LAST_7_DAYS",
  "search_term_status": [
    "NONE"
  ],
  "order_by": "conversions",
  "reason": "Find new converting search terms"
}

{
  "customer_id": "1234567890",
  "date_preset": "LAST_7_DAYS",
  "include_landing_pages": true,
  "reason": "Find which landing pages top search terms go to"
}

{
  "customer_id": "1234567890",
  "campaign_id": "5555555555",
  "date_preset": "LAST_30_DAYS",
  "pmax_search_categories": true,
  "reason": "PMax search category analysis"
}

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

{
  "customer_id": "1234567890",
  "date_preset": "LAST_30_DAYS",
  "cursor": "eyJvZmZzZXQiOjQwfQ==",
  "reason": "Fetch the next page of search terms using nextCursor from the previous response"
}