Get Google Ads campaign metrics

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

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

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/campaigns/metrics', 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/metrics",
  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/campaigns/metrics"

	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/campaigns/metrics")

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

{
  "metrics": {
    "21458812345": {
      "clicks": 137,
      "conversions": 6,
      "cost_micros": 48200000,
      "ctr": 0.028,
      "impressions": 4821
    }
  },
  "degraded": false
}

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

Campaigns

Get Google Ads campaign metrics

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

Reads live performance figures for every campaign on the account over a date window, in one call.

This goes to Google directly rather than to Base44’s nightly copy, so the numbers include today. Use it to fill in a table you first drew from List campaigns with include_metrics=false.

metrics is keyed by the Google Ads campaign ID, not Base44’s campaign ID. Join on the google_campaign_id field from the list endpoint. A campaign that had no activity in the window does not appear as a zero row, it is simply absent.

When Google cannot be reached you get an empty metrics map with degraded set to true, under a 200. Treat that as “unknown” rather than “nothing happened”.

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.

GET

api

apps

{app_id}

google-ads

campaigns

metrics

Get Google Ads campaign metrics

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

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

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/campaigns/metrics', 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/metrics",
  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/campaigns/metrics"

	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/campaigns/metrics")

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

{
  "metrics": {
    "21458812345": {
      "clicks": 137,
      "conversions": 6,
      "cost_micros": 48200000,
      "ctr": 0.028,
      "impressions": 4821
    }
  },
  "degraded": false
}

{
  "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 to include, as YYYY-MM-DD. Inclusive.

end_date

string

required

Last day to include, as YYYY-MM-DD. Inclusive.

Response

Metrics for each campaign with activity in the window.

Live metrics for every campaign on the account, keyed by Google's campaign ID.

metrics

Metrics · object

required

One entry per campaign, keyed by the Google Ads campaign ID. This is the google_campaign_id field from List campaigns, not Base44's id, so join on that field. Campaigns with no activity in the window are left out entirely.

Show child attributes

Example:

{
  "21458812345": {
    "clicks": 137,
    "conversions": 6,
    "cost_micros": 48200000,
    "ctr": 0.028,
    "impressions": 4821
  }
}

degraded

boolean

required

true when Google could not be reached and metrics is empty for that reason rather than because nothing ran. Always check this before showing zeros.

Example:

false

⌘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 campaign metrics

Authorizations

Path Parameters

Query Parameters

Response