Ad Insights

Generate keyword ideas

Changed on

Suggests new keywords from seed keywords or a website using Google Keyword Planner, with search volume, competition and bid estimates.

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.

post/v1/ads/keywords/ideas

Request

  • Base URL: https://zernio.com/api
  • URL: https://zernio.com/api/v1/ads/keywords/ideas
  • 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

seedKeywordsstring[]

Seed terms. Provide these, seedUrl, or both.

seedUrlstring uri

Landing page to mine for ideas. Provide this, seedKeywords, or both.

countriesstring[]

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

languageConstantIdstring

Google languageConstant id (1000 = English).

network'GOOGLE_SEARCH' | 'GOOGLE_SEARCH_AND_PARTNERS'
includeAdultKeywordsboolean
pageSizeinteger
pageTokenstring

Cursor from paging.nextPageToken of the previous page.

Response

Keyword idea 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