---
title: "Autocomplete Google Ads keyword themes"
method: GET
path: "/api/apps/{app_id}/google-ads/suggestions/keyword-themes"
---

# Autocomplete Google Ads keyword themes

`GET /api/apps/{app_id}/google-ads/suggestions/keyword-themes`

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Suggests keyword themes as someone types, for the keyword picker on a Smart campaign.

Returns matching theme names from Google's catalog, most relevant first, and never more than `limit`. Anything the caller types is still valid to save, so treat these as suggestions rather than the allowed set.

A `query` shorter than two characters returns an empty list rather than an error, because a one-character prefix matches too much to be useful. `country_code` scopes the catalog and is required in practice: Google returns nothing without one, so leaving it unset uses `US`.

`language_code` is best-effort. Google's catalog covers a fixed set of languages, and anything outside it falls back to English rather than failing, so a request for an unsupported language returns English themes with no signal that the substitution happened. Send a two-letter code; a regional tag like `pt-BR` is reduced to its first part.

An empty list also means Google was briefly unreachable, so treat "no suggestions" as "nothing to show right now" rather than "this word has no themes".

<Note>This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.</Note>

## Path parameters

- `app_id` string, required — ID of the app you are planning a Google Ads campaign for.

## Query parameters

- `query` string — Free-text the user is typing
- `language_code` string — Two-letter language code
- `country_code` string — Two-letter country code (scopes the catalog)
- `limit` integer — Most suggestions to return.

## Response `200`

Matching keyword theme names, most relevant first.

- string[]

## Other responses

- `401` — Missing or invalid credentials.
- `403` — You don't have access to this app, the app does not exist, or you used a workspace API key. A missing app and an app you cannot reach are deliberately the same answer.
- `422` — Validation Error

---

[API](https://skmtc.dev/base44/apis/base44-app-management-api.md) · [All operations](https://skmtc.dev/base44/apis/base44-app-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/base44/base44-app-management-api/revisions/173e4e9c63c2/schema)