Suggest Google Ads campaigns

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/campaigns/ai-suggestions \
  --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.",
  "landing_page_url": "https://nordwind-furniture.com",
  "campaign_goal": "traffic",
  "daily_budget_micros": 30000000,
  "suggestion_count": 3
}
'

import requests

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

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

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/campaigns/ai-suggestions', 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/campaigns/ai-suggestions",
  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.',
    'landing_page_url' => 'https://nordwind-furniture.com',
    'campaign_goal' => 'traffic',
    'daily_budget_micros' => 30000000,
    'suggestion_count' => 3
  ]),
  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/campaigns/ai-suggestions"

	payload := strings.NewReader("{\n  \"business_name\": \"Nordwind Furniture\",\n  \"business_description\": \"Handmade solid oak dining tables, built to order in San Francisco.\",\n  \"landing_page_url\": \"https://nordwind-furniture.com\",\n  \"campaign_goal\": \"traffic\",\n  \"daily_budget_micros\": 30000000,\n  \"suggestion_count\": 3\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/campaigns/ai-suggestions")
  .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  \"landing_page_url\": \"https://nordwind-furniture.com\",\n  \"campaign_goal\": \"traffic\",\n  \"daily_budget_micros\": 30000000,\n  \"suggestion_count\": 3\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"landing_page_url\": \"https://nordwind-furniture.com\",\n  \"campaign_goal\": \"traffic\",\n  \"daily_budget_micros\": 30000000,\n  \"suggestion_count\": 3\n}"

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

{
  "suggestions": [
    {
      "campaign_type": "SMART",
      "estimate_source": "heuristic",
      "estimated_daily_clicks": 24,
      "id": "smart-traffic",
      "payload": {
        "business_name": "Nordwind Furniture",
        "campaign_name": "Nordwind Furniture - Traffic",
        "campaign_type": "SMART",
        "daily_budget_micros": 30000000,
        "descriptions": [
          "Solid oak dining tables built to order."
        ],
        "headlines": [
          "Handmade Oak Tables"
        ],
        "images": [],
        "keyword_themes": [
          "handmade oak furniture"
        ],
        "landing_page": "https://nordwind-furniture.com",
        "logo_url": "",
        "settings": {
          "language_code": "en"
        }
      },
      "subtitle": "Best for raising overall visits to the site",
      "title": "Smart Search - drive traffic"
    }
  ],
  "source": "ai",
  "language": "en"
}

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

Campaigns

Suggest Google Ads campaigns

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

Turns a plain description of a business into two or three complete campaigns you can preview side by side and launch.

Each suggestion carries a payload you can send straight to Create campaign. The approaches differ by goal: Smart Search for traffic, Smart Search for leads, and Performance Max for leads. Nothing is saved.

You get at most three suggestions. suggestion_count accepts up to 5, but only three approaches exist, so 4 and 5 return the same three as 3 does.

The Performance Max suggestion cannot launch as-is: payload.logo_url and payload.images come back empty because this endpoint does not generate images, and Google requires both. Collect them before you send that payload.

Check source before presenting the copy as generated: fallback means the model did not run or returned nothing. title and subtitle are always English, even when the copy inside payload is in the app’s language, so translate them yourself if you show them to someone.

This one call runs two language-model requests and debits the shared quota twice.

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.

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

campaigns

ai-suggestions

Suggest Google Ads campaigns

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/campaigns/ai-suggestions \
  --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.",
  "landing_page_url": "https://nordwind-furniture.com",
  "campaign_goal": "traffic",
  "daily_budget_micros": 30000000,
  "suggestion_count": 3
}
'

import requests

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

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

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/campaigns/ai-suggestions', 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/campaigns/ai-suggestions",
  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.',
    'landing_page_url' => 'https://nordwind-furniture.com',
    'campaign_goal' => 'traffic',
    'daily_budget_micros' => 30000000,
    'suggestion_count' => 3
  ]),
  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/campaigns/ai-suggestions"

	payload := strings.NewReader("{\n  \"business_name\": \"Nordwind Furniture\",\n  \"business_description\": \"Handmade solid oak dining tables, built to order in San Francisco.\",\n  \"landing_page_url\": \"https://nordwind-furniture.com\",\n  \"campaign_goal\": \"traffic\",\n  \"daily_budget_micros\": 30000000,\n  \"suggestion_count\": 3\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/campaigns/ai-suggestions")
  .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  \"landing_page_url\": \"https://nordwind-furniture.com\",\n  \"campaign_goal\": \"traffic\",\n  \"daily_budget_micros\": 30000000,\n  \"suggestion_count\": 3\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"landing_page_url\": \"https://nordwind-furniture.com\",\n  \"campaign_goal\": \"traffic\",\n  \"daily_budget_micros\": 30000000,\n  \"suggestion_count\": 3\n}"

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

{
  "suggestions": [
    {
      "campaign_type": "SMART",
      "estimate_source": "heuristic",
      "estimated_daily_clicks": 24,
      "id": "smart-traffic",
      "payload": {
        "business_name": "Nordwind Furniture",
        "campaign_name": "Nordwind Furniture - Traffic",
        "campaign_type": "SMART",
        "daily_budget_micros": 30000000,
        "descriptions": [
          "Solid oak dining tables built to order."
        ],
        "headlines": [
          "Handmade Oak Tables"
        ],
        "images": [],
        "keyword_themes": [
          "handmade oak furniture"
        ],
        "landing_page": "https://nordwind-furniture.com",
        "logo_url": "",
        "settings": {
          "language_code": "en"
        }
      },
      "subtitle": "Best for raising overall visits to the site",
      "title": "Smart Search - drive traffic"
    }
  ],
  "source": "ai",
  "language": "en"
}

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

Authorizations

api_key

string

header

required

Personal API key.

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 to build campaigns for.

Example:

"Nordwind Furniture"

business_description

string

default:""

What the business sells, in a sentence or two. This is what the suggestions are built from.

Example:

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

landing_page_url

string

default:""

Page the campaigns would send people to.

Example:

"https://nordwind-furniture.com"

campaign_goal

string

default:traffic

What the campaigns are for: traffic, leads or sales.

Example:

"traffic"

daily_budget_micros

integer

default:30000000

Daily budget each suggestion is sized for, in micros (1,000,000 micros = 1 unit of the account's currency).

Example:

30000000

suggestion_count

integer

default:3

How many suggestions to return. Only three approaches exist, so 4 and 5 return the same three as 3.

Required range: 1 <= x <= 5

Example:

3

Response

Campaigns you can preview and launch.

Suggested campaigns for a business description.

suggestions

GoogleAdsCampaignSuggestion · object[]

required

The suggested campaigns, most general first. At most three, however many you asked for.

Show child attributes

Example:

[
  {
    "campaign_type": "SMART",
    "estimate_source": "heuristic",
    "estimated_daily_clicks": 24,
    "id": "smart-traffic",
    "payload": {
      "business_name": "Nordwind Furniture",
      "campaign_name": "Nordwind Furniture - Traffic",
      "campaign_type": "SMART",
      "daily_budget_micros": 30000000,
      "descriptions": ["Solid oak dining tables built to order."],
      "headlines": ["Handmade Oak Tables"],
      "images": [],
      "keyword_themes": ["handmade oak furniture"],
      "landing_page": "https://nordwind-furniture.com",
      "logo_url": "",
      "settings": { "language_code": "en" }
    },
    "subtitle": "Best for raising overall visits to the site",
    "title": "Smart Search - drive traffic"
  }
]

source

string

required

ai when a language model wrote the copy in these suggestions, fallback when it did not run or returned nothing.

Example:

"ai"

language

string | null

Two-letter code for the language the generated copy came back in, or null when the model did not report one.

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

Suggest Google Ads campaigns

Authorizations

Path Parameters

Body

Response