v2
latestOpenAPI 3.1.02026-08-075421692.0 MBList 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.
Query parameters
Page number (1-based)
Social account ID
Platform ad account ID (Google customer ID). Mirrors the same filter on /v1/ads.
Profile ID
Platform campaign ID
Platform ad group ID (Google ad group)
Keyword criterion status
true = negative keywords only, false = positive only. Omit for both.
Case-insensitive substring match on the keyword text
Response
Paginated keywords