Skip to main content
POST
Suggest Google Ads search themes

Authorizations

Authorization
string
header
required

Personal access token, sent as Authorization: Bearer <token>. Each operation lists the permission it needs: read_only or full_access. A full-access token can call every operation. A read-only token can call only the operations that list read_only; anything else returns 403 read_only_credential_route_not_allowed.

Headers

Accept-Language
string | null

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

Path Parameters

app_id
string
required

ID of the app you are planning a Google Ads campaign for.

Body

application/json
business_name
string
default:""

Name of the business the campaign is for.

Example:

"Nordwind Furniture"

business_description
string
default:""

What the business sells, in a sentence or two.

Example:

"Handmade solid oak dining tables, built to order in San Francisco."

landing_page_url
string
default:""

Page the campaign sends people to. Used as context.

Example:

"https://nordwind-furniture.com"

Response

Suggested search themes.

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.

Example: