Get Google Ads metric trend

curl --request GET \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/analytics/trend \
  --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/analytics/trend', 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/trend",
  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/trend"

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

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

[
  {
    "date": "2026-08-10",
    "value": 612,
    "clicks": 612,
    "conversions": 24
  }
]

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

Reporting

Get Google Ads metric trend

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

Returns one metric as a time series for a date window, bucketed daily, weekly or monthly.

metric is one of impressions, clicks, cost_micros, conversions, conversions_value, ctr, or average_cpc_micros. Anything else is rejected with a 400.

ctr and average_cpc_micros are rates, so each bucket is computed from the underlying counts rather than by adding up the daily rates. A bucket with no impressions has a ctr of 0, and one with no clicks has an average_cpc_micros of 0.

granularity is DAILY, WEEKLY or MONTHLY and defaults to DAILY. Weekly buckets are anchored to Monday. Buckets with no activity are not returned, so expect gaps rather than zeroes.

An account with no synced campaigns returns an empty list.

These numbers come from Base44’s own nightly copy of your Google Ads metrics, not from Google directly, so the last few hours of activity can be missing.

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

analytics

trend

Get Google Ads metric trend

curl --request GET \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/analytics/trend \
  --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/analytics/trend', 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/trend",
  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/trend"

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

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

[
  {
    "date": "2026-08-10",
    "value": 612,
    "clicks": 612,
    "conversions": 24
  }
]

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

metric

string

required

The metric to chart: impressions, clicks, cost_micros, conversions, conversions_value, ctr, or average_cpc_micros.

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.

granularity

string

default:DAILY

Bucket size: DAILY, WEEKLY (Monday-anchored), or MONTHLY.

Response

One entry per bucket with activity, oldest first.

date

string

required

First day of the bucket, as YYYY-MM-DD. For WEEKLY this is the Monday, for MONTHLY the first of the month.

Example:

"2026-08-10"

value

number

required

The requested metric for the bucket, rounded to two decimals.

Example:

612

clicks

integer

required

Clicks in the bucket, always included so you can chart a second series without another call.

Example:

612

conversions

number

required

Conversions in the bucket, always included for the same reason.

Example:

24

⌘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 metric trend

Authorizations

Path Parameters

Query Parameters

Response