Suggest Google Ads text assets

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/suggestions/text-assets \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "business_name": "Nordwind Furniture",
  "business_description": "Handmade solid oak dining tables, built to order in San Francisco.",
  "asset_types": [
    "HEADLINE",
    "DESCRIPTION"
  ],
  "keywords": [
    "oak dining table"
  ],
  "search_themes": [
    "handmade oak furniture"
  ],
  "user_prompt": "Emphasise the free delivery."
}
'

import requests

url = "https://app.base44.com/api/apps/{app_id}/google-ads/suggestions/text-assets"

payload = {
    "business_name": "Nordwind Furniture",
    "business_description": "Handmade solid oak dining tables, built to order in San Francisco.",
    "asset_types": ["HEADLINE", "DESCRIPTION"],
    "keywords": ["oak dining table"],
    "search_themes": ["handmade oak furniture"],
    "user_prompt": "Emphasise the free delivery."
}
headers = {
    "api_key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    business_name: 'Nordwind Furniture',
    business_description: 'Handmade solid oak dining tables, built to order in San Francisco.',
    asset_types: ['HEADLINE', 'DESCRIPTION'],
    keywords: ['oak dining table'],
    search_themes: ['handmade oak furniture'],
    user_prompt: 'Emphasise the free delivery.'
  })
};

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/suggestions/text-assets', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.base44.com/api/apps/{app_id}/google-ads/suggestions/text-assets",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'business_name' => 'Nordwind Furniture',
    'business_description' => 'Handmade solid oak dining tables, built to order in San Francisco.',
    'asset_types' => [
        'HEADLINE',
        'DESCRIPTION'
    ],
    'keywords' => [
        'oak dining table'
    ],
    'search_themes' => [
        'handmade oak furniture'
    ],
    'user_prompt' => 'Emphasise the free delivery.'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "api_key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/google-ads/suggestions/text-assets"

	payload := strings.NewReader("{\n  \"business_name\": \"Nordwind Furniture\",\n  \"business_description\": \"Handmade solid oak dining tables, built to order in San Francisco.\",\n  \"asset_types\": [\n    \"HEADLINE\",\n    \"DESCRIPTION\"\n  ],\n  \"keywords\": [\n    \"oak dining table\"\n  ],\n  \"search_themes\": [\n    \"handmade oak furniture\"\n  ],\n  \"user_prompt\": \"Emphasise the free delivery.\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("api_key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.base44.com/api/apps/{app_id}/google-ads/suggestions/text-assets")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"business_name\": \"Nordwind Furniture\",\n  \"business_description\": \"Handmade solid oak dining tables, built to order in San Francisco.\",\n  \"asset_types\": [\n    \"HEADLINE\",\n    \"DESCRIPTION\"\n  ],\n  \"keywords\": [\n    \"oak dining table\"\n  ],\n  \"search_themes\": [\n    \"handmade oak furniture\"\n  ],\n  \"user_prompt\": \"Emphasise the free delivery.\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/google-ads/suggestions/text-assets")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["api_key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"business_name\": \"Nordwind Furniture\",\n  \"business_description\": \"Handmade solid oak dining tables, built to order in San Francisco.\",\n  \"asset_types\": [\n    \"HEADLINE\",\n    \"DESCRIPTION\"\n  ],\n  \"keywords\": [\n    \"oak dining table\"\n  ],\n  \"search_themes\": [\n    \"handmade oak furniture\"\n  ],\n  \"user_prompt\": \"Emphasise the free delivery.\"\n}"

response = http.request(request)
puts response.read_body

{
  "HEADLINE": [
    "Handmade Oak Tables",
    "Built To Order"
  ],
  "LONG_HEADLINE": [
    "Solid oak dining tables, built to order in San Francisco"
  ],
  "DESCRIPTION": [
    "Free statewide delivery on every table we build."
  ],
  "BUSINESS_NAME": "Nordwind Furniture",
  "CALL_TO_ACTION_SELECTION": [
    "LEARN_MORE",
    "SHOP_NOW",
    "SIGN_UP",
    "CONTACT_US"
  ]
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Suggestions and lookups

Suggest Google Ads text assets

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

Suggests text assets for a Performance Max campaign, one group per asset type you ask for.

Send asset_types with any of HEADLINE, LONG_HEADLINE, DESCRIPTION, BUSINESS_NAME and CALL_TO_ACTION_SELECTION. Only the types you ask for come back, so read the response by key rather than assuming all five are present. BUSINESS_NAME is a single string; the rest are arrays. CALL_TO_ACTION_SELECTION is a fixed set of values Google accepts rather than generated copy.

Nothing is saved. An asset type can come back as an empty array when the model returns nothing usable for it, under a 200.

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.

POST

api

apps

{app_id}

google-ads

suggestions

text-assets

Suggest Google Ads text assets

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/suggestions/text-assets \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "business_name": "Nordwind Furniture",
  "business_description": "Handmade solid oak dining tables, built to order in San Francisco.",
  "asset_types": [
    "HEADLINE",
    "DESCRIPTION"
  ],
  "keywords": [
    "oak dining table"
  ],
  "search_themes": [
    "handmade oak furniture"
  ],
  "user_prompt": "Emphasise the free delivery."
}
'

import requests

url = "https://app.base44.com/api/apps/{app_id}/google-ads/suggestions/text-assets"

payload = {
    "business_name": "Nordwind Furniture",
    "business_description": "Handmade solid oak dining tables, built to order in San Francisco.",
    "asset_types": ["HEADLINE", "DESCRIPTION"],
    "keywords": ["oak dining table"],
    "search_themes": ["handmade oak furniture"],
    "user_prompt": "Emphasise the free delivery."
}
headers = {
    "api_key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    business_name: 'Nordwind Furniture',
    business_description: 'Handmade solid oak dining tables, built to order in San Francisco.',
    asset_types: ['HEADLINE', 'DESCRIPTION'],
    keywords: ['oak dining table'],
    search_themes: ['handmade oak furniture'],
    user_prompt: 'Emphasise the free delivery.'
  })
};

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/suggestions/text-assets', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.base44.com/api/apps/{app_id}/google-ads/suggestions/text-assets",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'business_name' => 'Nordwind Furniture',
    'business_description' => 'Handmade solid oak dining tables, built to order in San Francisco.',
    'asset_types' => [
        'HEADLINE',
        'DESCRIPTION'
    ],
    'keywords' => [
        'oak dining table'
    ],
    'search_themes' => [
        'handmade oak furniture'
    ],
    'user_prompt' => 'Emphasise the free delivery.'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "api_key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/google-ads/suggestions/text-assets"

	payload := strings.NewReader("{\n  \"business_name\": \"Nordwind Furniture\",\n  \"business_description\": \"Handmade solid oak dining tables, built to order in San Francisco.\",\n  \"asset_types\": [\n    \"HEADLINE\",\n    \"DESCRIPTION\"\n  ],\n  \"keywords\": [\n    \"oak dining table\"\n  ],\n  \"search_themes\": [\n    \"handmade oak furniture\"\n  ],\n  \"user_prompt\": \"Emphasise the free delivery.\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("api_key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.base44.com/api/apps/{app_id}/google-ads/suggestions/text-assets")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"business_name\": \"Nordwind Furniture\",\n  \"business_description\": \"Handmade solid oak dining tables, built to order in San Francisco.\",\n  \"asset_types\": [\n    \"HEADLINE\",\n    \"DESCRIPTION\"\n  ],\n  \"keywords\": [\n    \"oak dining table\"\n  ],\n  \"search_themes\": [\n    \"handmade oak furniture\"\n  ],\n  \"user_prompt\": \"Emphasise the free delivery.\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/google-ads/suggestions/text-assets")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["api_key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"business_name\": \"Nordwind Furniture\",\n  \"business_description\": \"Handmade solid oak dining tables, built to order in San Francisco.\",\n  \"asset_types\": [\n    \"HEADLINE\",\n    \"DESCRIPTION\"\n  ],\n  \"keywords\": [\n    \"oak dining table\"\n  ],\n  \"search_themes\": [\n    \"handmade oak furniture\"\n  ],\n  \"user_prompt\": \"Emphasise the free delivery.\"\n}"

response = http.request(request)
puts response.read_body

{
  "HEADLINE": [
    "Handmade Oak Tables",
    "Built To Order"
  ],
  "LONG_HEADLINE": [
    "Solid oak dining tables, built to order in San Francisco"
  ],
  "DESCRIPTION": [
    "Free statewide delivery on every table we build."
  ],
  "BUSINESS_NAME": "Nordwind Furniture",
  "CALL_TO_ACTION_SELECTION": [
    "LEARN_MORE",
    "SHOP_NOW",
    "SIGN_UP",
    "CONTACT_US"
  ]
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

api_key

string

header

required

Personal API key.

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 assets are 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."

asset_types

string[]

Which asset types to generate: HEADLINE, LONG_HEADLINE, DESCRIPTION, BUSINESS_NAME, CALL_TO_ACTION_SELECTION. Only the types you list come back.

Example:

["HEADLINE", "DESCRIPTION"]

keywords

string[]

Words the copy should lean on.

Example:

["oak dining table"]

search_themes

string[]

Search themes the campaign already uses, so the copy matches them.

Example:

["handmade oak furniture"]

user_prompt

string

default:""

Extra direction for the copy, in the caller's own words.

Example:

"Emphasise the free delivery."

Response

One group per asset type you asked for.

Suggested text for each asset type you asked for.

HEADLINE

string[] | null

Short headlines, each within Google's 30-character limit. Present only when you asked for HEADLINE.

Example:

["Handmade Oak Tables", "Built To Order"]

LONG_HEADLINE

string[] | null

Long headlines, each within Google's 90-character limit. Present only when you asked for LONG_HEADLINE.

Example:

[
  "Solid oak dining tables, built to order in San Francisco"
]

DESCRIPTION

string[] | null

Description lines, each within Google's 90-character limit. Present only when you asked for DESCRIPTION.

Example:

[
  "Free statewide delivery on every table we build."
]

BUSINESS_NAME

string | null

A single business name, trimmed to Google's 25-character limit. This one is a string rather than an array, unlike every other asset type here. Present only when you asked for BUSINESS_NAME.

Example:

"Nordwind Furniture"

CALL_TO_ACTION_SELECTION

string[] | null

Call-to-action values Google accepts. This is a fixed list, not a generated one. Present only when you asked for CALL_TO_ACTION_SELECTION.

Example:

[
  "LEARN_MORE",
  "SHOP_NOW",
  "SIGN_UP",
  "CONTACT_US"
]

⌘I

App Management API (Beta)

Entities API (Beta)

Virality API (Beta)

Workflows API (Beta)

Analytics API (Beta)

Google Ads API (Beta)

Monitoring API

Audit Logs API

Suggest Google Ads text assets

Authorizations

Headers

Path Parameters

Body

Response