Get Google Ads conversion stats

Changed on

<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

Request

  • Base URL: https://app.base44.com
  • URL: https://app.base44.com/api/apps/{app_id}/google-ads/conversions/stats
  • Auth: HTTP bearer

Path parameters

app_idstring required

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.

end_datestring required

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

  • b92cc2f13639Revision changes
    • info

      the security scope read_only was added to the endpoint's security scheme PersonalAccessTokenAuth

    • info

      the security scope full_access was removed from the endpoint's security scheme PersonalAccessTokenAuth

  • 5e139db2e643Revision changes
    • info

      the endpoint scheme security PersonalAccessTokenAuth was added to the API