Sign in

Get Google Ads conversion stats

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

Returns conversions and conversion value per campaign for a date window.

Only campaigns with activity in the window are returned, and archived campaigns are left out. 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 be YYYY-MM-DD. This endpoint does not reject a malformed date: it compares the value as text, so a date in another format silently matches the wrong days.</Note>

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

get/api/apps/{app_id}/google-ads/conversions/stats

Path parameters

app_idstring required

ID of the app whose Google Ads conversion tracking you want to manage.

ID of the app whose Google Ads conversion tracking you want to manage.

Query parameters

start_datestring required

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

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

end_datestring required

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

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

Response

One entry per campaign with conversions in the window.

campaign_idstring required

The Google Ads campaign ID. This is not the Base44 campaign ID the campaign endpoints take, which is reported as id by List campaigns.

conversionsnumber required

Conversions recorded for the campaign in the window.

conversions_valuenumber required

Total value of those conversions, in the account's currency.

Example response

[
  {
    "campaign_id": "21458812345",
    "conversions": 24,
    "conversions_value": 1830
  }
]

Changes

Changed in 1 of the 10 revisions of this API.1