# Get Google search terms report (adsap_google_search_terms)

Returns the search terms report: the real queries that triggered your Search and Shopping ads, with impressions, clicks, cost and conversions per term.

Canonical: https://adsap.ai/docs/tools/adsap_google_search_terms
Updated: 2026-09-13

**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.

## Parameters

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

| Name | Type | Required | Description |
|---|---|---|---|
| `ad_account_id` | string | Yes | Bare 10-digit Google Ads customer ID (from adsap_google_list_ad_accounts). No dashes, no act_ prefix. |
| `date_preset` | one of `last_7d`, `last_14d`, `last_30d` | No | Date range preset (default last_30d). Ignored when date_from/date_to are set. |
| `date_from` | string | No | Custom range start, YYYY-MM-DD. Use with date_to. |
| `date_to` | string | No | Custom range end, YYYY-MM-DD. Use with date_from. |
| `campaign_id` | string | No | Restrict to one campaign (numeric id from adsap_google_list_campaigns). |
| `limit` | number | No | Max terms returned, ordered by cost descending. |

## 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`](/tools/adsap_google_keyword_ideas): Get keyword suggestions with search volume from Google Keyword Planner for a Google Search campaign.
- [`adsap_google_manage_keywords`](/tools/adsap_google_manage_keywords): Manage Google Ads Search keywords AFTER creation.
- [`adsap_google_manage_targeting`](/tools/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`](/tools/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](/guides/google-ads/search) for the workflow around this tool, and the [Tool reference](/tools) for every tool.