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.
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: 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.
Last updated on