Get Google search terms report (adsap_google_search_terms)

Platform: Google Ads · Read or write: Read · Plan: Early Access · Consumes a task: No · Preview supported: No

What it does

Returns the search terms report: the real queries that triggered your Search and Shopping ads, with impressions, clicks, cost and conversions per term. Use it to find wasted queries to add as negatives and converting queries to add as exact keywords.

When to use it

• Use it to see what people typed before they saw your Search or Shopping ads, and what each query cost.
• It reads the report live from Google. Rows are totals for the date range, sorted by cost, highest first.
• The range is last_7d, last_14d or last_30d, or a custom date_from and date_to pair. The default is last_30d.
• campaign_id from adsap_google_list_campaigns narrows it to one campaign. limit goes up to 500.
• It only reads. To add a query as a keyword or a negative, use adsap_google_manage_keywords.

Worked example

You ask

“Which search terms cost the most in campaign 21000000001 over the last 7 days? The account is 1234567890.”

The assistant calls adsap_google_search_terms

{
  "ad_account_id": "1234567890",
  "date_preset": "last_7d",
  "campaign_id": "21000000001",
  "limit": 50
}

Adsap returns

The field names are the ones Adsap returns. The values are examples.

{
  "ok": true,
  "data": [
    {
      "search_term": "trail running shoes",
      "status": "ADDED",
      "campaign_id": "21000000001",
      "campaign_name": "Spring sale",
      "ad_group_id": "31000000001",
      "ad_group_name": "Trail shoes",
      "impressions": 1800,
      "clicks": 120,
      "cost": 96.4,
      "conversions": 9,
      "conversions_value": 720,
      "cpc": 0.8
    },
    {
      "search_term": "free running shoes",
      "status": "NONE",
      "campaign_id": "21000000001",
      "campaign_name": "Spring sale",
      "ad_group_id": "31000000001",
      "ad_group_name": "Trail shoes",
      "impressions": 950,
      "clicks": 64,
      "cost": 41.6,
      "conversions": 0,
      "conversions_value": 0,
      "cpc": 0.65
    }
  ],
  "meta": {
    "total_count": 2,
    "truncated": false,
    "date_range": { "from": "2026-09-11", "to": "2026-09-17" },
    "campaign_id": "21000000001"
  }
}

How to read it

status says whether the term is already in the account: ADDED is a keyword, EXCLUDED is a negative, ADDED_EXCLUDED is both, and NONE is neither. cost and cpc are amounts in the account currency. cpc is null when a term has no clicks.

Here “free running shoes” has status NONE, 64 clicks and no conversions, so it is a candidate for a negative keyword. A NONE term that converts well is worth adding as an exact keyword. When meta.truncated is true, the list hit limit and more terms exist. meta.note (not shown) repeats this guidance.

Parameters

Descriptions are shortened from the tool schema. Your assistant sees the full text.

Example prompts

• “Show me the search terms that cost the most with zero conversions in the last 30 days.”
• “Which search queries converted best in my Brand campaign this month?”
• “List the top 50 search terms by cost for campaign 1234567890 since September 1.”

Notes

The same term can appear once per ad group; those are not duplicates. Google omits terms with zero impressions in the range.

Related tools

• adsap_google_keyword_ideas: Get keyword suggestions with search volume from Google Keyword Planner for a Google Search campaign.
• adsap_google_manage_keywords: Manage Google Ads Search keywords AFTER creation.
• adsap_google_manage_targeting: Manage a Google Ads campaign or ad group’s targeting AFTER creation: GEO, LANGUAGE and AUDIENCES.
• adsap_google_search_geo_targets: Find Google Ads geo target constants by location name (city, region, country, postal area) for Search campaign location targeting.

Guide

Read Google Search campaigns for the workflow around this tool, and the Tool reference for every tool.

The Google Ads MCP server  page shows how to connect Google Ads to Claude, ChatGPT or Perplexity.