> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Suggest Google Ads search themes
> This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.
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.
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.
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.
This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.
## OpenAPI
````yaml /developers/references/app-management/app-management-openapi.json post /api/apps/{app_id}/google-ads/suggestions/search-themes
openapi: 3.1.0
info:
title: Base44 App Management API
version: 1.0.0
servers:
- url: https://app.base44.com
security:
- ApiKeyAuth: []
paths:
/api/apps/{app_id}/google-ads/suggestions/search-themes:
post:
summary: Suggest Google Ads search themes
description: >-
This API is in beta. Endpoints, fields, and behavior may still
change, so avoid depending on it in production.
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.
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.
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.
This endpoint accepts a personal API key. Workspace API keys are
not authorized for it and are rejected with a 403.
operationId: >-
suggest_search_themes_api_apps__app_id__google_ads_suggestions_search_themes_post
parameters:
- name: app_id
in: path
required: true
schema:
type: string
description: ID of the app you are planning a Google Ads campaign for.
title: App Id
description: ID of the app you are planning a Google Ads campaign for.
example: 6820f3a4e7b91d003c45a1f2
- name: Accept-Language
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: >-
Language to return generated text in, as a standard
`Accept-Language` value. An unsupported language falls back to
English.
title: Accept-Language
description: >-
Language to return generated text in, as a standard
`Accept-Language` value. An unsupported language falls back to
English.
example: de
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/SearchThemesRequest'
responses:
'200':
description: Suggested search themes.
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleAdsSearchThemes'
'401':
description: Missing or invalid credentials.
'403':
description: >-
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':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
'429':
description: The shared AI quota for this app is spent. Retry in a minute.
components:
schemas:
SearchThemesRequest:
properties:
business_name:
type: string
title: Business Name
description: Name of the business the campaign is for.
default: ''
example: Nordwind Furniture
business_description:
type: string
title: Business Description
description: What the business sells, in a sentence or two.
default: ''
example: Handmade solid oak dining tables, built to order in San Francisco.
landing_page_url:
type: string
title: Landing Page Url
description: Page the campaign sends people to. Used as context.
default: ''
example: https://nordwind-furniture.com
type: object
title: SearchThemesRequest
GoogleAdsSearchThemes:
properties:
search_themes:
items:
type: string
type: array
title: Search Themes
description: >-
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.
example:
- handmade oak furniture
- custom dining tables
- san francisco woodworking
type: object
required:
- search_themes
title: GoogleAdsSearchThemes
description: Short themes describing what a Performance Max campaign should match.
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
type: object
required:
- loc
- msg
- type
title: ValidationError
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: api_key
description: Personal API key.
````