v2

latestOpenAPI 3.1.02026-08-075421692.0 MB
Ad Campaigns

List Search keywords

Returns the Google Search keyword criteria (positive and negative) synced from connected Google Ads accounts, one row per ad-group keyword. Refreshed about once a week per Google Ads customer (the keyword sweep rides the ads discovery pass on a slower slot, to stay inside Google's shared daily API quota), so keywords added on Google can take several days to appear. A customer synced for the first time is populated on the next discovery pass rather than waiting for its weekly slot, and connecting an account or triggering a manual sync refreshes it immediately. Campaign-level negative keywords are not included; only ad-group-level criteria are.

get/v1/ads/keywords

Query parameters

pageinteger

Page number (1-based)

limitinteger
accountIdstring

Social account ID

adAccountIdstring

Platform ad account ID (Google customer ID). Mirrors the same filter on /v1/ads.

profileIdstring

Profile ID

campaignIdstring

Platform campaign ID

adSetIdstring

Platform ad group ID (Google ad group)

status'active' | 'paused'

Keyword criterion status

matchType'exact' | 'phrase' | 'broad' | 'unknown'
negativeboolean

true = negative keywords only, false = positive only. Omit for both.

searchstring

Case-insensitive substring match on the keyword text

Response

Paginated keywords