---
title: "Generate keyword ideas (Google Keyword Planner)"
method: POST
path: "/v1/ads/keywords/ideas"
tags: ["Ad Insights"]
---

# Generate keyword ideas (Google Keyword Planner)

`POST /v1/ads/keywords/ideas`

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.

## Request body

- object
  - `accountId` string, required — Zernio googleads SocialAccount id.
  - `customerId` string — Numeric Google Ads customer id (no dashes); only needed when the connection has several accounts.
  - `seedKeywords` string[] — Seed terms. Provide these, seedUrl, or both.
  - `seedUrl` string, uri — Landing page to mine for ideas. Provide this, seedKeywords, or both.
  - `countries` string[] — ISO 3166-1 alpha-2 country codes. Omitted = worldwide.
  - `languageConstantId` string — Google languageConstant id (1000 = English).
  - `network` 'GOOGLE_SEARCH' | 'GOOGLE_SEARCH_AND_PARTNERS'
  - `includeAdultKeywords` boolean
  - `pageSize` integer
  - `pageToken` string — Cursor from paging.nextPageToken of the previous page.

## Response `200`

Keyword idea rows (raw Keyword Planner shape)

- object
  - `customerId` string — The customer the request ran against.
  - `data` object[]
  - `aggregateMetricResults` object, nullable
  - `paging` object
    - `nextPageToken` string, nullable — Cursor for the next page; null when exhausted.

## Other responses

- `400` — Invalid input, or Google rejected the request — message carries Google's error
- `401` — Unauthorized
- `429` — Per-user Google Ads operations budget or the shared Google quota reached; the message says which and when it resets.
- `501` — Only supported on Google Ads

---

[API](https://skmtc.net/zernio/apis/zernio-api.md) · [All operations](https://skmtc.net/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zernio/zernio-api/revisions/15e893e69e8c/schema)