Ad Campaigns

List Search keywords

Changed on

Lists the keywords and negative keywords in your Google Search ad groups.

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 day per Google Ads customer (the keyword sweep rides the ads discovery pass on a slower slot), so keywords added on Google can take up to a day to appear. A customer synced for the first time is populated on the next discovery pass rather than waiting for its daily 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

Request

  • Base URL: https://zernio.com/api
  • URL: https://zernio.com/api/v1/ads/keywords
  • Auth: HTTP bearer

Query parameters

pageinteger

Page number (1-based)

limitinteger
accountIdstring

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'

Accepted in any case.

negativeboolean

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

searchstring

Case-insensitive substring match on the keyword text

Response

Paginated keywords

Changes

  • f8c8f34fb41aRevision changes
    • warning

      added the new account enum value to the / response property for the response status

    • warning

      added the new account enum value to the / response property for the response status

  • d556591af3f6Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status