Search Terms Report
search_terms_reportSearch terms report. Returns terms (the FULL list, one row per search term with impressions, clicks, cost, conversions and ctr) plus three curated buckets: converters, waste_candidates (negative-keyword candidates) and already_negative (terms that an EXISTING negative — ad group, campaign or shared list — already blocks, with the matching negative named; never propose these again). sort: cost | impressions | clicks | conversions. min_clicks: 0 (default) INCLUDES terms that got impressions but no clicks — raise it to 1 to see only clicked terms. limit: max rows (default 1000). Google withholds very low-volume terms behind its privacy threshold, so the list is never exhaustive. DATE: if period ('today','yesterday','this_month','last_7_days'… or 'YYYY-MM-DD[:...]') is provided, it overrides days; days=0 = today. start_date/end_date (YYYY-MM-DD) are accepted as an explicit range too. campaign_id: optional, one id or comma-separated ids, limits the report (and limit) to those campaigns. SMART (Smart/akıllı) campaigns are included in terms with campaign_type='SMART' (Google exposes only impressions, clicks and cost for them, conversions=null; they are left out of the buckets).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | ||
| sort | No | cost | |
| limit | No | ||
| period | No | ||
| end_date | No | ||
| min_waste | No | ||
| min_clicks | No | ||
| start_date | No | ||
| campaign_id | No | ||
| customer_id | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||