Suggest Google Ads search themes
Changed on<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.
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 or a workspace API key. A workspace API key acts as the workspace owner.</Note>
Request
- Base URLhttps://app.base44.com
- Auth
- HTTP bearer
- or API key in header api_key
- or HTTP bearer
Path parameters
ID of the app you are planning a Google Ads campaign for.
Headers
Language to return generated text in, as a standard Accept-Language value. An unsupported language falls back to English.
Request body
Example request
{
"business_name": "Nordwind Furniture",
"business_description": "Handmade solid oak dining tables, built to order in San Francisco.",
"landing_page_url": "https://nordwind-furniture.com"
}Response
Suggested search themes.
Example response
{
"search_themes": [
"handmade oak furniture",
"custom dining tables",
"san francisco woodworking"
]
}Changes
- info
added the non-success response with the status
- info
- info
the endpoint scheme security
WorkspaceApiKeyAuthwas added to the API - info
the endpoint scheme security
WorkspaceApiKeyBearerAuthwas added to the API
- info