---
title: "Get Google Ads metric trend"
method: GET
path: "/api/apps/{app_id}/google-ads/analytics/trend"
---

# Get Google Ads metric trend

`GET /api/apps/{app_id}/google-ads/analytics/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>

## 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 — Bucket size: `DAILY`, `WEEKLY` (Monday-anchored), or `MONTHLY`.

## Response `200`

One entry per bucket with activity, oldest first.

- MetricTrendPoint[]
  - `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.
  - `value` number, required — The requested metric for the bucket, rounded to two decimals.
  - `clicks` integer, required — Clicks in the bucket, always included so you can chart a second series without another call.
  - `conversions` number, required — Conversions in the bucket, always included for the same reason.

## Other responses

- `400` — `metric` is not one of the supported metrics, `granularity` is not `DAILY`, `WEEKLY` or `MONTHLY`, or a date is not `YYYY-MM-DD`.
- `401` — Missing or invalid credentials.
- `403` — You don't have access to this app, the app does not exist, or you used a workspace API key. A missing app and an app you cannot reach are deliberately the same answer.
- `404` — The app has no connected Google Ads account.
- `422` — Validation Error

## Changes

- **2026-08-26** `f2727732ced1` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/idealspot/apis/base44-app-management-api/changes/api/apps/:app_id/google-ads/analytics/trend/get.md)

---

[API](https://skmtc.dev/idealspot/apis/base44-app-management-api.md) · [All operations](https://skmtc.dev/idealspot/apis/base44-app-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/idealspot/base44-app-management-api/revisions/31ef75eb64ab/schema)