Google Ads / API Reference
google_ads_bulk_add_search_terms_as_negatives
Google Ads tool. Prefer the actions marked RECOMMENDED for everyday Google Ads workflows. Bulk-add multiple search terms as negative keywords in one call. Use after reviewing the search terms report to block wasteful queries. Args: customer_id: Google Ads customer ID. search_terms_json: JSON array of objects with 'text' and 'match_type'. Example: '[{"text": "free", "match_type": "BROAD"}, {"text": "diy shoes", "match_type": "EXACT"}]' campaign_id: Add as campaign-level negatives to this campaign. adgroup_id: Add as ad-group-level negatives to this ad group. shared_set_id: Add to this shared negative keyword list.
This is a read-only tool: it returns bulk add search terms as negatives for 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:
Bulk add search terms as negatives in my Google Ads account for [search terms json].
It takes 2 required and 3 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
customer_id | string | Yes | Customer Id |
search_terms_json | string | Yes | Search Terms Json |
campaign_id | string | No | Campaign Id |
adgroup_id | string | No | Adgroup Id |
shared_set_id | string | No | Shared Set Id |
Related Google Ads tools
google_ads_bulk_create_keywordsgoogle_ads_account_overviewgoogle_ads_ad_performancegoogle_ads_ad_schedule_reportgoogle_ads_add_adgroup_negative_keywordsgoogle_ads_add_audience_to_campaign
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: