OverviewProductsPlatformsAPI ReferenceResources
Accounts & Ops

Replace negative list keywords

PUThttps://zernio.com/api/v1/ads/accounts/negative-keyword-lists/{listId}/keywords

Replaces all keywords in a shared Google Ads negative keyword list (or clears it), affecting every campaign that uses the list.

  • Existing keywords are diffed by normalized text and match type.
  • Creates and removals are applied atomically in one mutation. Unchanged criteria retain their ids.
  • Send an empty keywords array to clear the list.
  • Changes affect every campaign using this list.
PlatformsGoogle

Authentication

AuthorizationBearer tokenRequired

API key authentication: send your Zernio API key in the Authorization header, prefixed with Bearer.

Path parameters

listIdstringRequired

Google shared set id.

Body

application/json

What every request needs

accountIdstringRequired

Zernio SocialAccount id.

keywordsarray of KeywordEntryRequired

Full desired keyword set. Bare strings use broad match. Send [] to clear the list.

Optional parameters3 fields
adAccountIdstring

Platform ad account ID (Google customer ID, digits only). Required when the connection has multiple customers.

customerIdDeprecatedstring

Alias of adAccountId, kept for existing callers

platformstringOne of facebook | instagram | tiktok | linkedin | pinterest | google | twitter | openai | reddit

Optional courtesy field. The resolved account or campaign determines support; other platforms return 501.

Responses

Success· the request worked

Errors· the request failed

How it behaves

Quota

Each create or removal consumes one daily operation; the entire batch must fit the remaining quota.

PUT/v1/ads/accounts/negative-keyword-lists/{listId}/keywords
import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.adaccounts.replaceAdNegativeKeywordListKeywords({  path: {    listId: 'list_abc123',  },  body: {    accountId: 'account_abc123',    keywords: [      'string',    ],  },});console.log(data);
{  "created": 1,  "removed": 1,  "customerId": "9122445560"}
OpenAPI specification
Was this page helpful?