`google_ads_list_negative_keywords`

List Google Ads Negative Keywords

Google

Description

List negative keywords at the campaign and/or ad-group level. Supports filtering by campaign, ad group, match type, and level. Always fetches fresh data. Use this during search term audits to cross-check recommended negatives against existing ones.

Read-onlyIdempotentOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "google_ads_list_negative_keywords",
    "arguments": {
      "customer_id": "1234567890",
      "reason": "Audit negative keywords"
    }
  }
}

hopkin google negative-keywords list

Flag	Type	Required	Description
`--customer-id`	`string`	Required	The Google Ads Customer ID (10 digits, with or without dashes)
`--login-customer-id`	`string`	Optional	MCC (Manager) Customer ID; required for managed accounts
`--campaign`	`string`	Optional	Filter to a specific campaign ID
`--ad-group-id`	`string`	Optional	Filter to a specific ad group ID
`--level`	`string`	Optional	Which level of negative keywords to return. Defaults to ALL.
`--match-type`	`array`	Optional	Filter by match type: EXACT, PHRASE, BROAD
`--limit`	`integer`	Optional	Number of negative keywords per page (default: 20, max: 100)
`--cursor`	`string`	Optional	Pagination cursor from previous response

{
  "mcpServers": {
    "google-ads": {
      "url": "https://mcp.hopkin.ai/google-ads/mcp",
      "transport": "sse"
    }
  }
}

All negatives
Campaign level
Filter by match type

Parameters

Name	Type	Required	Description
`customer_id`	`string`	Required	The Google Ads Customer ID (10 digits, with or without dashes)pattern: ^[\d-]+$
`reason`	`string`	Required	Why this tool call is neededminLength: 1, maxLength: 500

Optional parameters (7)

Name	Type	Required	Description
`login_customer_id`	`string`	Optional	MCC (Manager) Customer ID; required for managed accountspattern: ^[\d-]+$
`campaign_id`	`string`	Optional	Filter to a specific campaign IDpattern: ^\d+$
`ad_group_id`	`string`	Optional	Filter to a specific ad group IDpattern: ^\d+$
`level`	`string`	Optional	Which level of negative keywords to return. Defaults to ALL. `CAMPAIGN` `AD_GROUP` `ALL`
`match_type`	`array`	Optional	Filter by match type: EXACT, PHRASE, BROAD
`limit`	`integer`	Optional	Number of negative keywords per page (default: 20, max: 100)min: 1, max: 100
`cursor`	`string`	Optional	Pagination cursor from previous responseminLength: 1

Examples

All negatives

{
  "customer_id": "1234567890",
  "reason": "Audit negative keywords"
}

hopkin google negative-keywords list --customer-id 1234567890

Campaign level

{
  "customer_id": "1234567890",
  "campaign_id": "5555555555",
  "level": "CAMPAIGN",
  "reason": "Cross-check campaign negatives during search term audit"
}

hopkin google negative-keywords list --customer-id 1234567890 --campaign 5555555555 --level CAMPAIGN

Filter by match type

{
  "customer_id": "1234567890",
  "match_type": [
    "BROAD"
  ],
  "reason": "Find broad match negatives that may be too aggressive"
}

hopkin google negative-keywords list --customer-id 1234567890 --match-type BROAD