add_negative_keywords_to_list

Google Ads Write

Add negative keywords to a SHARED negative keyword list

Endpoint

POST https://api.adspirer.ai/api/v1/tools/add_negative_keywords_to_list/execute

Headers

Authorization: Bearer sk_live_... — your Adspirer API key (required)
Content-Type: application/json (required)
Idempotency-Key: <uuid> — recommended for write operations to make retries safe

Description

Add negative keywords to a SHARED negative keyword list.

Adds negatives to a reusable list (SharedSet), so every campaign the list is
attached to blocks those searches at once — no need to repeat per campaign.

**Parameters:**
- shared_set_id (required — from list_negative_keyword_lists)
- keywords (required): each {text, match_type} — match_type EXACT, PHRASE, or BROAD (default BROAD)

**Use when:** "add these negatives to my shared list", "block 'free', 'cheap' across
all my campaigns via the list".

Request body

All tool arguments are wrapped in an arguments object.

Field	Type	Description
`shared_set_id`	`string` required	The negative keyword list ID (shared set ID). Get it from list_negative_keyword_lists.
`customer_id`	`string` optional	Google Ads customer ID. Required for multi-account users.
`keywords`	`array` required	Negative keywords to add, each {text, match_type}. match_type EXACT/PHRASE/BROAD (default BROAD).

Example request

{
  "arguments": {
    "shared_set_id": "string",
    "keywords": [
      {
        "text": "string",
        "match_type": "BROAD"
      }
    ],
    "customer_id": "string"
  }
}

Example responses

200 — Success

{
  "success": true,
  "data": {
    "text": "(tool-specific textual output for add_negative_keywords_to_list)",
    "quota": {
      "used": 42,
      "limit": 150,
      "tier": "plus",
      "period_end": "2026-05-01"
    }
  },
  "tool": "add_negative_keywords_to_list"
}

400 — Tool-level error (bad arguments / multi-account selection)

{
  "success": false,
  "error": "You have 25 meta_ads accounts connected. Please specify which account to use by passing the ad_account_id parameter:\n  - Acme Holdings (ad_account_id=\"act_123456789\")\n  - Acme EU (ad_account_id=\"act_987654321\")",
  "is_error": true,
  "tool": "add_negative_keywords_to_list"
}

402 — Quota exhausted

{
  "success": false,
  "error": "\ud83d\udea8 Monthly limit reached (150/150 tool calls on Plus tier).\nUpgrade to Pro at https://adspirer.ai to keep building.",
  "is_error": true,
  "tool": "add_negative_keywords_to_list",
  "quota": {
    "used": 150,
    "limit": 150,
    "tier": "plus",
    "period_end": "2026-05-01",
    "upgrade_url": "https://adspirer.ai"
  }
}

Try it live

Interactive: Swagger UI

Machine-readable: OpenAPI 3.1 spec · llms-full.txt

More tools: Google Ads · All tools

Adspirer REST API — get an API key at adspirer.ai/keys · adspirer.ai