List Google Ads insights

curl --request GET \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/analytics/insights \
  --header 'api_key: <api-key>'

import requests

url = "https://app.base44.com/api/apps/{app_id}/google-ads/analytics/insights"

headers = {"api_key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {api_key: '<api-key>'}};

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/analytics/insights', 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/analytics/insights",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "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"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/google-ads/analytics/insights"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("api_key", "<api-key>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Get.new(url)
request["api_key"] = '<api-key>'

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

[
  {
    "id": "increase_budget:21458812345",
    "severity": "medium",
    "title": "Increase budget for Spring sale - Search",
    "description": "This campaign is consistently spending its full daily budget. Raising it could capture more clicks and conversions.",
    "action": "edit_budget",
    "action_payload": {
      "campaign_ids": [
        "68b1c0d4e7b91d003c45a1f2"
      ],
      "field": "budget",
      "value": 30000000
    },
    "source": "google",
    "recommendation_type": "CAMPAIGN_BUDGET"
  }
]

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

Reporting

List Google Ads insights

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

Returns the account’s suggestion feed for a date window: what to change, on which campaigns, and how urgent it is.

The feed merges Base44’s own suggestions with Google Ads’ budget recommendations and ad-strength findings. Base44 removes the overlaps, so a campaign that both sides flag for the same reason appears once. Suggestions you dismissed are left out.

action_payload.campaign_ids holds Base44 campaign IDs on Base44’s own suggestions, and Google Ads campaign IDs on ad-strength ones (recommendation_type AD_STRENGTH_DROP). Check recommendation_type before passing an ID to another endpoint.

Google’s half of the feed is best-effort: when Google Ads is unavailable you get Base44’s suggestions alone, under a 200 and with nothing in the response to say so.

An account with no synced campaigns returns an empty list.

start_date and end_date are inclusive and must both be YYYY-MM-DD. Anything else is rejected with a 400.

This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.

The response includes fields beyond the ones documented here. Don’t rely on undocumented response fields, as they can change at any time.

GET

api

apps

{app_id}

google-ads

analytics

insights

List Google Ads insights

curl --request GET \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/analytics/insights \
  --header 'api_key: <api-key>'

import requests

url = "https://app.base44.com/api/apps/{app_id}/google-ads/analytics/insights"

headers = {"api_key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {api_key: '<api-key>'}};

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/analytics/insights', 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/analytics/insights",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "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"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/google-ads/analytics/insights"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("api_key", "<api-key>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Get.new(url)
request["api_key"] = '<api-key>'

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

[
  {
    "id": "increase_budget:21458812345",
    "severity": "medium",
    "title": "Increase budget for Spring sale - Search",
    "description": "This campaign is consistently spending its full daily budget. Raising it could capture more clicks and conversions.",
    "action": "edit_budget",
    "action_payload": {
      "campaign_ids": [
        "68b1c0d4e7b91d003c45a1f2"
      ],
      "field": "budget",
      "value": 30000000
    },
    "source": "google",
    "recommendation_type": "CAMPAIGN_BUDGET"
  }
]

{
  "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 whose Google Ads reporting you want to read.

Query Parameters

start_date

string

required

First day of the window, as YYYY-MM-DD. Inclusive.

end_date

string

required

Last day of the window, as YYYY-MM-DD. Inclusive.

Response

The account's suggestions, most urgent first.

string

required

Stable ID for the suggestion. Pass it as insight_id to Dismiss insight to stop it coming back.

Example:

"increase_budget:21458812345"

severity

string

required

How urgent the suggestion is: high, medium, or low.

Example:

"medium"

title

string

required

One-line summary of the suggestion.

Example:

"Increase budget for Spring sale - Search"

description

string

required

The suggestion in full, written for an app owner to read as-is.

Example:

"This campaign is consistently spending its full daily budget. Raising it could capture more clicks and conversions."

action

string | null

What resolving the suggestion involves: edit_budget, edit_sitelinks, improve_assets, or open_campaign. null when Base44 could not resolve a campaign to act on.

Example:

"edit_budget"

action_payload

Action Payload · object

The values the suggestion proposes. campaign_ids names the campaigns it applies to, field and value carry a proposed budget in micros where there is one.

Example:

{
  "campaign_ids": ["68b1c0d4e7b91d003c45a1f2"],
  "field": "budget",
  "value": 30000000
}

source

string | null

google when the suggestion is Google Ads' own recommendation rather than Base44's. Absent on Base44's own suggestions.

Example:

"google"

recommendation_type

string | null

Present with source. CAMPAIGN_BUDGET for a Google budget recommendation, AD_STRENGTH_DROP for an ad-strength one.

Example:

"CAMPAIGN_BUDGET"

⌘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

List Google Ads insights

Authorizations

Path Parameters

Query Parameters

Response