Google Ads / API Reference
gads_get_campaign_search_term_insights
Google Ads tool (extended/low-level coverage). For common tasks prefer the RECOMMENDED google_ads_* actions; use these only for advanced operations those don't cover. Get search term insights (search categories) for a campaign — works for Performance Max. Uses campaign_search_term_insight, which is the only resource that reports search data for Performance Max; search_term_view returns zero rows for PMax. Note Google exposes a search *category* here rather than the raw query, and provides no cost or CPC (not selectable on this resource). For exact queries with spend on Search/Shopping campaigns, use google_ads_search_terms instead.
This is a read-only tool: it retrieves campaign search term insights from your Google Ads account. It changes nothing.
Ask Claude
You do not call this tool yourself. Ask for the outcome and the client picks the tool:
Get campaign search term insights in my Google Ads account for [campaign id], [start date], [end date].
It takes 3 required and 2 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
campaign_id | string | Yes | Campaign Id |
start_date | string | Yes | Start Date |
end_date | string | Yes | End Date |
limit | integer | No | Limit |
customer_id | string | No | Customer Id |
Related Google Ads tools
gads_get_campaign_ai_max_statusgads_get_campaign_bidding_detailsgads_get_campaign_detailsgads_get_campaign_draftgads_get_campaign_experimentgads_get_campaign_frequency_cap
Before you can call it
This tool needs a connected Google Ads account. The Google Ads connect guide covers the OAuth flow and the permissions it asks for, and the quickstart gets a client talking to the server in about five minutes.
Workflows that use this
Rather than calling tools one at a time, these skills run a whole procedure against the same account: