Replace negative list 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.
Authentication
API key authentication: send your Zernio API key in the Authorization header, prefixed with Bearer.
Path parameters
Google shared set id.
Body
application/jsonWhat every request needs
Zernio SocialAccount id.
Full desired keyword set. Bare strings use broad match. Send [] to clear the list.
Optional parameters3 fields
Platform ad account ID (Google customer ID, digits only). Required when the connection has multiple customers.
Alias of adAccountId, kept for existing callers
facebook | instagram | tiktok | linkedin | pinterest | google | twitter | openai | redditOptional 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.
Delete a negative keyword list
Deletes a shared Google Ads negative keyword list; detach it from every campaign first. Detach it from all campaigns first; an in-use list is rejected. Only NEGATIVE_KEYWORDS shared sets are supported.
List value rule sets
Lists a Meta ad account's value rule sets, which raise or lower bids for audience segments you value differently. Lists the ad account's value rule sets (Meta's `/act_X/value_rule_set`). A value rule set adjusts the auction bid up or down for audience segments you value differently; attach one to an ad set with `valueRuleSetId` on `POST /v1/ads/create` or `PUT /v1/ads/ad-sets/{adSetId}`. Rows are returned in the same camelCase shape the `PUT` body takes, ids included, so a set round-trips 1:1: **the update is a full replace, not a patch**, so you GET, mutate and send the whole thing back. Limits: 6 rule sets per ad account, 10 rules per set, 4 criteria per rule. **Rule order is semantic.** Rules are evaluated in array order and only the FIRST matching rule adjusts the bid for an overlapping audience. The order you send is the order that is stored and returned. Eligibility: value rule sets apply only to ad sets on the `LOWEST_COST_WITHOUT_CAP` (auto-bid) or `COST_CAP` bid strategies. Meta rejects the rest server-side.