Generate Google Ads ad copy

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/ai/generate-copy \
  --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.",
  "keywords": [
    "oak dining table",
    "handmade furniture"
  ],
  "landing_page_url": "https://nordwind-furniture.com",
  "campaign_goal": "traffic"
}
'

import requests

url = "https://app.base44.com/api/apps/{app_id}/google-ads/ai/generate-copy"

payload = {
    "business_name": "Nordwind Furniture",
    "business_description": "Handmade solid oak dining tables, built to order in San Francisco.",
    "keywords": ["oak dining table", "handmade furniture"],
    "landing_page_url": "https://nordwind-furniture.com",
    "campaign_goal": "traffic"
}
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.',
    keywords: ['oak dining table', 'handmade furniture'],
    landing_page_url: 'https://nordwind-furniture.com',
    campaign_goal: 'traffic'
  })
};

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/ai/generate-copy', 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/ai/generate-copy",
  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.',
    'keywords' => [
        'oak dining table',
        'handmade furniture'
    ],
    'landing_page_url' => 'https://nordwind-furniture.com',
    'campaign_goal' => 'traffic'
  ]),
  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/ai/generate-copy"

	payload := strings.NewReader("{\n  \"business_name\": \"Nordwind Furniture\",\n  \"business_description\": \"Handmade solid oak dining tables, built to order in San Francisco.\",\n  \"keywords\": [\n    \"oak dining table\",\n    \"handmade furniture\"\n  ],\n  \"landing_page_url\": \"https://nordwind-furniture.com\",\n  \"campaign_goal\": \"traffic\"\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/ai/generate-copy")
  .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  \"keywords\": [\n    \"oak dining table\",\n    \"handmade furniture\"\n  ],\n  \"landing_page_url\": \"https://nordwind-furniture.com\",\n  \"campaign_goal\": \"traffic\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/google-ads/ai/generate-copy")

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  \"keywords\": [\n    \"oak dining table\",\n    \"handmade furniture\"\n  ],\n  \"landing_page_url\": \"https://nordwind-furniture.com\",\n  \"campaign_goal\": \"traffic\"\n}"

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

{
  "headlines": [
    "Handmade Oak Tables",
    "Free Statewide Delivery",
    "Built To Order"
  ],
  "descriptions": [
    "Solid oak dining tables built to order in San Francisco. Free delivery."
  ],
  "source": "ai",
  "language": "en"
}

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

Suggestions and lookups

Generate Google Ads ad copy

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

Writes headlines and descriptions for a campaign from a business name and description.

Nothing is saved. Take the fields you want and pass them to Create campaign, or to Create campaign brief to keep them for later.

Check source before you present this as generated copy. Anything other than ai means the model did not produce copy and the response is fallback text derived from what you sent, returned under a 200. headlines and descriptions can also come back empty.

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

generate-copy

Generate Google Ads ad copy

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/ai/generate-copy \
  --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.",
  "keywords": [
    "oak dining table",
    "handmade furniture"
  ],
  "landing_page_url": "https://nordwind-furniture.com",
  "campaign_goal": "traffic"
}
'

import requests

url = "https://app.base44.com/api/apps/{app_id}/google-ads/ai/generate-copy"

payload = {
    "business_name": "Nordwind Furniture",
    "business_description": "Handmade solid oak dining tables, built to order in San Francisco.",
    "keywords": ["oak dining table", "handmade furniture"],
    "landing_page_url": "https://nordwind-furniture.com",
    "campaign_goal": "traffic"
}
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.',
    keywords: ['oak dining table', 'handmade furniture'],
    landing_page_url: 'https://nordwind-furniture.com',
    campaign_goal: 'traffic'
  })
};

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/ai/generate-copy', 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/ai/generate-copy",
  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.',
    'keywords' => [
        'oak dining table',
        'handmade furniture'
    ],
    'landing_page_url' => 'https://nordwind-furniture.com',
    'campaign_goal' => 'traffic'
  ]),
  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/ai/generate-copy"

	payload := strings.NewReader("{\n  \"business_name\": \"Nordwind Furniture\",\n  \"business_description\": \"Handmade solid oak dining tables, built to order in San Francisco.\",\n  \"keywords\": [\n    \"oak dining table\",\n    \"handmade furniture\"\n  ],\n  \"landing_page_url\": \"https://nordwind-furniture.com\",\n  \"campaign_goal\": \"traffic\"\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/ai/generate-copy")
  .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  \"keywords\": [\n    \"oak dining table\",\n    \"handmade furniture\"\n  ],\n  \"landing_page_url\": \"https://nordwind-furniture.com\",\n  \"campaign_goal\": \"traffic\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/google-ads/ai/generate-copy")

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  \"keywords\": [\n    \"oak dining table\",\n    \"handmade furniture\"\n  ],\n  \"landing_page_url\": \"https://nordwind-furniture.com\",\n  \"campaign_goal\": \"traffic\"\n}"

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

{
  "headlines": [
    "Handmade Oak Tables",
    "Free Statewide Delivery",
    "Built To Order"
  ],
  "descriptions": [
    "Solid oak dining tables built to order in San Francisco. Free delivery."
  ],
  "source": "ai",
  "language": "en"
}

{
  "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

required

Name of the business the ads are for.

Example:

"Nordwind Furniture"

business_description

string

default:""

What the business sells, in a sentence or two. The more specific this is, the better the copy.

Example:

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

keywords

string[]

Words the copy should lean on.

Example:

["oak dining table", "handmade furniture"]

landing_page_url

string

default:""

Page the ads send people to. Used as context for the copy.

Example:

"https://nordwind-furniture.com"

campaign_goal

string

default:traffic

What the campaign is for: traffic, leads or sales.

Example:

"traffic"

Response

Suggested headlines and descriptions.

Headlines and descriptions for a campaign's ads.

headlines

string[]

required

Suggested headlines, each within Google's 30-character limit.

Example:

[
  "Handmade Oak Tables",
  "Free Statewide Delivery",
  "Built To Order"
]

descriptions

string[]

required

Suggested description lines, each within Google's 90-character limit.

Example:

[
  "Solid oak dining tables built to order in San Francisco. Free delivery."
]

source

string

required

ai when a language model wrote this copy. Any other value means it did not, and you are looking at fallback text built from the business details you sent.

Example:

"ai"

language

string | null

Two-letter code for the language the copy came back in, or null when the model did not report one. Pass it as settings.language_code on Create campaign so the campaign's language matches its copy.

Example:

"en"

⌘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

Generate Google Ads ad copy

Authorizations

Headers

Path Parameters

Body

Response