Historical keyword metrics (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.
API key authentication - use your Zernio API key as a Bearer token
In: header
Zernio googleads SocialAccount id.
Numeric Google Ads customer id (no dashes); only needed when the connection has several accounts.
1 <= items <= 1000ISO 3166-1 alpha-2 country codes. Omitted = worldwide.
1 <= items <= 10Google languageConstant id (1000 = English).
"1000""GOOGLE_SEARCH""GOOGLE_SEARCH" | "GOOGLE_SEARCH_AND_PARTNERS"Adds averageCpcMicros to each row's keywordMetrics.
Response Body
application/json
application/json
import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.adinsights.generateKeywordHistoricalMetrics({ body: { accountId: 'account_abc123', keywords: [ 'string', ], },});console.log(data);{
"customerId": "string",
"data": [
{}
],
"aggregateMetricResults": {}
}{
"error": "Unauthorized"
}Get campaign analytics GET
Returns performance analytics for a whole campaign in one call: summary metrics, a daily timeline over the requested date range (summed across the campaign's ads), and optional demographic breakdowns. Breakdowns are fetched live from Meta at the campaign level (one call per dimension, no per-ad fan-out), so an agency dashboard gets campaign-level age/gender/etc. without summing thousands of per-ad reads. `campaignId` is the platform campaign id; pass `platform` when a campaign id could be ambiguous across platforms. If no date range is provided, defaults to the last 90 days. Date range is capped at 730 days max.
Generate keyword ideas (Google Keyword Planner) POST
Google Ads only. Runs Keyword Planner's generateKeywordIdeas from seed keywords, a seed URL, or both, returning idea rows verbatim (avgMonthlySearches, competition, competitionIndex, top-of-page bid micros, monthlySearchVolumes). Counters are int64s encoded as strings; bid values are micros of the account currency. Omitting `countries` targets worldwide.