Get Google Ads performance dashboard

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

import requests

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

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/dashboard', 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/dashboard",
  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/dashboard"

	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/dashboard")

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

{
  "spend": 1240.75,
  "impressions": 52100,
  "clicks": 1830,
  "roas": 2.35,
  "campaign_breakdown": [
    {
      "campaign_type": "SEARCH",
      "clicks": 612,
      "conversions": 24,
      "conversions_value": 1830,
      "ctr": 3.33,
      "id": "21458812345",
      "impressions": 18400,
      "name": "Spring sale - Search",
      "spend": 412.5,
      "status": "ENABLED"
    }
  ],
  "includes_estimated": false,
  "spend_trend": 12.4,
  "impressions_trend": -3.2,
  "clicks_trend": 8.1,
  "conversions": 64,
  "conversions_trend": 15,
  "roas_trend": 4.7,
  "top_search_terms": [
    {
      "clicks": 17,
      "term": "oak dining table"
    }
  ],
  "monthly_spend_cap_micros": 50000000,
  "trend": [
    {
      "clicks": 48,
      "conversions": 3,
      "date": "2026-08-14"
    }
  ],
  "conversion_goals": [
    {
      "category": "PURCHASE",
      "conversions": 12,
      "name": "Purchase"
    }
  ]
}

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

Reporting

Get Google Ads performance dashboard

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

Returns the account’s spend, clicks, impressions, conversions and return on ad spend for a date window, each with its change against the previous window of the same length, plus a per-campaign breakdown.

Base44 reads these numbers from Google Ads on every call. When Google is unavailable it falls back to its own nightly copy, which is the same shape minus trend and conversion_goals: write your client to treat both as optional rather than assuming the live shape.

Archived campaigns stay in both the totals and the breakdown, so the rows always sum to the figures above them.

conversions and conversions_trend are null for an account that records no conversions and has no conversion tracking configured, so a real zero stays distinguishable from an untracked account. List conversion actions shows whether the account has any goals at all.

Set include_campaign_trend to false to drop the per-campaign daily sparkline. It costs one Google Ads row per campaign per day, so leaving it on is noticeably slower on an account with many campaigns and a long window.

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

dashboard

Get Google Ads performance dashboard

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

import requests

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

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/dashboard', 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/dashboard",
  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/dashboard"

	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/dashboard")

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

{
  "spend": 1240.75,
  "impressions": 52100,
  "clicks": 1830,
  "roas": 2.35,
  "campaign_breakdown": [
    {
      "campaign_type": "SEARCH",
      "clicks": 612,
      "conversions": 24,
      "conversions_value": 1830,
      "ctr": 3.33,
      "id": "21458812345",
      "impressions": 18400,
      "name": "Spring sale - Search",
      "spend": 412.5,
      "status": "ENABLED"
    }
  ],
  "includes_estimated": false,
  "spend_trend": 12.4,
  "impressions_trend": -3.2,
  "clicks_trend": 8.1,
  "conversions": 64,
  "conversions_trend": 15,
  "roas_trend": 4.7,
  "top_search_terms": [
    {
      "clicks": 17,
      "term": "oak dining table"
    }
  ],
  "monthly_spend_cap_micros": 50000000,
  "trend": [
    {
      "clicks": 48,
      "conversions": 3,
      "date": "2026-08-14"
    }
  ],
  "conversion_goals": [
    {
      "category": "PURCHASE",
      "conversions": 12,
      "name": "Purchase"
    }
  ]
}

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

include_campaign_trend

boolean

default:true

Include each campaign's daily series in campaign_breakdown[].trend. Set it to false to leave the series out, which is significantly faster on an account with many campaigns or a long window.

Response

The account's totals for the window, plus a row per campaign.

Account-wide totals for the window, plus a per-campaign breakdown.

spend

number

required

Amount spent in the window, in the account's currency.

Example:

1240.75

impressions

integer

required

Impressions in the window.

Example:

52100

clicks

integer

required

Clicks in the window.

Example:

1830

roas

number

required

Return on ad spend: conversion value divided by spend. 0 when nothing was spent.

Example:

2.35

campaign_breakdown

DashboardCampaignRow · object[]

required

One row per campaign that has metrics in the window, archived campaigns included, so the rows sum to the totals above.

Show child attributes

Example:

[
  {
    "campaign_type": "SEARCH",
    "clicks": 612,
    "conversions": 24,
    "conversions_value": 1830,
    "ctr": 3.33,
    "id": "21458812345",
    "impressions": 18400,
    "name": "Spring sale - Search",
    "spend": 412.5,
    "status": "ENABLED"
  }
]

includes_estimated

boolean

required

true when some rows are Base44's own estimate rather than a figure Google reported.

Example:

false

spend_trend

number | null

Percentage change in spend against the previous window of the same length. null when the previous window had no spend to compare against.

Example:

12.4

impressions_trend

number | null

Percentage change in impressions against the previous window.

Example:

-3.2

clicks_trend

number | null

Percentage change in clicks against the previous window.

Example:

8.1

conversions

number | null

Conversions in the window. null when the account has no conversion tracking configured and recorded none, because the number would read as a real zero.

Example:

64

conversions_trend

number | null

Percentage change in conversions against the previous window. null whenever conversions is null.

Example:

15

roas_trend

number | null

Percentage change in return on ad spend against the previous window.

Example:

4.7

top_search_terms

DashboardTopSearchTerm · object[]

Up to four search terms that drove the most clicks in the last 30 days, regardless of the window you asked for. Empty when the term read failed or the account has no campaigns yet.

Show child attributes

Example:

[
  { "clicks": 17, "term": "oak dining table" }
]

monthly_spend_cap_micros

integer

default:0

The account's monthly spend cap in micros, or 0 when no cap is set. Absent when the account has no synced campaigns yet.

Example:

50000000

trend

DashboardTrendPoint · object[] | null

Account-wide daily series for the window. Absent when Base44 served its own copy of the numbers instead of Google's live figures.

Show child attributes

Example:

[
  {
    "clicks": 48,
    "conversions": 3,
    "date": "2026-08-14"
  }
]

conversion_goals

DashboardConversionGoal · object[] | null

Every conversion goal on the account with its count for the window. Absent when Base44 served its own copy of the numbers, and null when the goal read failed.

Show child attributes

Example:

[
  {
    "category": "PURCHASE",
    "conversions": 12,
    "name": "Purchase"
  }
]

⌘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

Get Google Ads performance dashboard

Authorizations

Path Parameters

Query Parameters

Response