Sign in
Ad Campaigns

List campaign-level negative keywords

Returns the campaign-level negative keywords (campaign_criterion.negative), distinct from the ad-group-level negatives under GET /v1/ads/keywords. Cached for the quota window (not synced to Postgres), and gated by the shared Google Ads operations budget like every other on-demand Google surface. The response carries cachedAt and stale, set when a quota-exhausted call falls back to the last-good copy instead of a live read.

The platform is always discovered from the campaign itself; a non-Google campaign returns 501 rather than 404, whether or not platform was passed.

get/v1/ads/campaigns/{campaignId}/negative-keywords

Path parameters

campaignIdstring required

Platform campaign ID

Query parameters

platform'facebook' | 'instagram' | 'tiktok' | 'linkedin' | 'pinterest' | 'google' | 'twitter' | 'openai'

Optional and NOT authoritative: the resolved campaign's own platform decides 200 vs 501, never this hint.

Response

Campaign-level negative keywords

cachedAtstring date-time nullable

When this list was fetched from Google. Null when it was never served from cache.

staleboolean

True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read.

Changes

Changed in 1 of the 55 revisions of this API.1