Get Google Ads metric trend

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

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.

<Note>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.</Note>

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

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

app_idstring required

ID of the app whose Google Ads reporting you want to read.

metricstring required

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

start_datestring required

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

end_datestring required

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

granularitystring

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

Response

One entry per bucket with activity, oldest first.

datestring required

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

valuenumber required

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

clicksinteger required

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

conversionsnumber required

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

Example response

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

Get Google Ads metric trend

Path parameters

Query parameters

Response

Example response

Changes