Negatives
POST /api/v1/accounts/{projectId}/negative-keywords
Propose blocking search terms at campaign or ad-group level.
POST /api/v1/accounts/{projectId}/negative-keywordsPropose blocking search terms at campaign or ad-group level.
The safest write in the API: a negative can only ever reduce spend.
Requires a key with write scope or higher.
Returns 200 on success.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
projectId | path | string | yes | The Google Ads account, as returned by GET /api/v1/accounts. |
Request body
| Field | Type | Required | Description |
|---|---|---|---|
level | campaign | ad_group | yes | |
campaign_id | string | no | Google Ads resource id (numeric string). |
ad_group_id | string | no | Google Ads resource id (numeric string). |
keywords | object[] | yes | |
reason | string | yes | Why this change is being made. Shown in /approvals and /history. |
auto_apply | boolean | no | Allow the safe-apply policy to apply this change without approval if it classifies as safe. Defaults to false — the change queues in /approvals. Default: false. |
Example
curl -X POST "https://bidandscale.com/api/v1/accounts/{projectId}/negative-keywords" \
-H "Authorization: Bearer $BIDANDSCALE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ … }'