---
title: "Suggest Google Ads search themes"
method: POST
path: "/api/apps/{app_id}/google-ads/suggestions/search-themes"
---

# Suggest Google Ads search themes

`POST /api/apps/{app_id}/google-ads/suggestions/search-themes`

## Request

- Base URL: `https://app.base44.com`
- URL: `https://app.base44.com/api/apps/{app_id}/google-ads/suggestions/search-themes`
- Auth: HTTP bearer

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

Suggests search themes for a Performance Max campaign.

Search themes tell Google what the campaign is about when there are no keywords to match on. Nothing is saved: pass the ones you want to [Create campaign](/api-reference/create-google-ads-campaign).

You get at most 10 themes, each trimmed to 80 characters, and themes naming the platform itself are dropped. An empty list is a 200, so check the array rather than the status code.

<Note>This endpoint runs a language model and draws on a shared quota of 20 requests per minute per app, which every Google Ads AI endpoint debits. Enterprise workspaces get a higher quota. A 429 means the quota is spent, not that this endpoint has its own limit.</Note>

<Note>The copy is written in the language you send in the `Accept-Language` header. Omit the header and you get English — the app's own language is not consulted — so send it explicitly for a non-English app.</Note>

<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.

## Headers

- `Accept-Language` string: Language to return generated text in, as a standard `Accept-Language` value. An unsupported language falls back to English.

## Request body

- SearchThemesRequest
  - `business_name` string: Name of the business the campaign is for.
  - `business_description` string: What the business sells, in a sentence or two.
  - `landing_page_url` string: Page the campaign sends people to. Used as context.

## Response `200`

Suggested search themes.

- GoogleAdsSearchThemes: Short themes describing what a Performance Max campaign should match.
  - `search_themes` string[], required: Up to 10 themes, each at most 80 characters. Pass them as `search_themes` when you create a Performance Max campaign. An empty list means the model returned nothing usable.

## 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. Marketing setup, campaign edits, generation and resuming also return `app_marketing_not_allowed` when the app's owning workspace has the FERPA designation. Historical reads, pausing, deletion and financial settlement remain available.
- `422`: Validation Error
- `429`: The shared AI quota for this app is spent. Retry in a minute.

## Changes

> 58 revisions in range; 1 not diffed.

- **2026-10-21** `c23775445de2`: 1 breaking, 1 info
  - `header` request parameter `Accept-Language` list-of-types was narrowed by removing types `null`
  - for the `header` request parameter `Accept-Language`, the type was generalized from no type to `string`
- **2026-10-12** `5e139db2e643`: 1 info
  - the endpoint scheme security `PersonalAccessTokenAuth` was added to the API

[Operation history](https://skmtc.dev/adexad/apis/base44-app-management-api/changes/api/apps/:app_id/google-ads/suggestions/search-themes/post.md)

---

[API](https://skmtc.dev/adexad/apis/base44-app-management-api.md) · [All operations](https://skmtc.dev/adexad/apis/base44-app-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/adexad/apis/base44-app-management-api/revisions/fa29e915c226?raw)