Ad Insights

Get historical keyword metrics

Changed on

Gets historical search volume, competition and bid ranges for up to 1,000 keywords from Google Keyword Planner.

Google Ads only. Runs Keyword Planner's generateKeywordHistoricalMetrics for up to 1,000 exact keywords: historical search volume, competition and top-of-page bid ranges, plus averageCpcMicros when includeAverageCpc is set. Rows come back verbatim; counters are int64s encoded as strings, bid/CPC values are micros of the account currency.

post/v1/ads/keywords/historical-metrics

Request

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

Request body

accountIdstring required

Zernio googleads SocialAccount id.

adAccountIdstring

Platform ad account ID (Google customer ID, digits only).

customerIdstring

Alias of adAccountId, kept for existing callers

keywordsstring[] required
countriesstring[]

ISO 3166-1 alpha-2 country codes. Omitted = worldwide.

languageConstantIdstring

Google languageConstant id (1000 = English).

network'GOOGLE_SEARCH' | 'GOOGLE_SEARCH_AND_PARTNERS'
includeAdultKeywordsboolean
includeAverageCpcboolean

Adds averageCpcMicros to each row's keywordMetrics.

Response

Historical metric rows (raw Keyword Planner shape)

customerIdstring

The customer the request ran against.

dataobject[]
aggregateMetricResultsobject nullable

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