Ad Insights

Google Ads search terms report

Changed on

Shows the actual Google searches that triggered your ads, with spend and results, so you can spot wasted spend and add negative keywords.

The actual search queries that triggered your ads, with matched-keyword status and spend metrics, the raw material for wasted-spend analysis and negative-keyword lists. Reads Google's search_term_view, cached for the quota window; defaults to the last 30 days. Rows are ordered by cost, descending. Draws on the shared Google Ads operations budget. The response carries cachedAt and stale, set when a quota-exhausted call falls back to the last-good copy instead of a live read.

get/v1/ads/search-terms

Request

  • Base URL: https://zernio.com/api
  • URL: https://zernio.com/api/v1/ads/search-terms
  • Auth: HTTP bearer

Query parameters

accountIdstring required

Google ads SocialAccount id.

adAccountIdstring

Platform ad account ID (Google customer ID, digits only). Defaults to the account's connected customer.

customerIdstring

Alias of adAccountId, kept for existing callers

fromDatestring date

Defaults to 30 days ago.

toDatestring date

Defaults to today.

campaignIdstring

Numeric Google campaign id filter.

adSetIdstring

Platform ad set ID (Google ad group). Same value as adSetId on listAdKeywords and /ad-sets/{adSetId}/assets.

adGroupIdstring

Alias of adSetId, kept for existing callers.

pageTokenstring

Cursor from paging.nextPageToken of the previous page.

Response

Search terms

customerIdstring
cachedAtstring date-time nullable

When this data 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

  • 450ec6ec5b0eRevision changes
    • info

      added the non-success response with the status

  • 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

    • 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