Get Google Ads campaign targeting

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

Reads a campaign’s current targeting from Google Ads: the themes it matches, the terms it excludes, and the locations on each side.

This reads Google directly rather than Base44’s copy, so it is the authoritative set to seed an editor from. Send changes back with Update campaign.

Location entries carry a camel-cased resourceName, unlike the rest of this API. A location saved before Base44 recorded display names comes back with its numeric ID as name; nothing repairs that later, so resolve the label through Search locations if you need to show it.

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/campaigns/{campaign_id}/targeting

Get Google Ads campaign targeting

cURL

curl --request GET \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/campaigns/{campaign_id}/targeting \
  --header 'Authorization: Bearer <token>'

200

{
  "keyword_themes": [
    "handmade oak furniture",
    "custom dining tables"
  ],
  "excluded_terms": [
    "free",
    "repair"
  ],
  "targeted_locations": [
    {
      "name": "San Francisco",
      "resourceName": "geoTargetConstants/1014221"
    }
  ],
  "excluded_locations": [
    {
      "name": "Oakland",
      "resourceName": "geoTargetConstants/1014044"
    }
  ],
  "language_code": "en",
  "proximity": {
    "city": "Austin",
    "country": "US",
    "postal_code": "",
    "radius": 10,
    "radius_units": "miles",
    "street": ""
  }
}

Authorizations

Authorization · string · header · required

Personal access token, sent as Authorization: Bearer <token>. Each operation lists the permission it needs: read_only or full_access. A full-access token can call every operation. A read-only token can call only the operations that list read_only; anything else returns 403 read_only_credential_route_not_allowed.

Path Parameters

app_id · string · required

ID of the app whose Google Ads campaigns to manage.

campaign_id · string · required

Base44's ID for the campaign, as returned in id by List campaigns. This is not the Google Ads campaign ID, which is reported separately as google_campaign_id.

Response

200

application/json

The campaign's live targeting.

What a campaign currently targets, read live from Google.

keyword_themes · string[] · required

The themes the campaign matches on.

Example:

[
  "handmade oak furniture",
  "custom dining tables"
]

excluded_terms · string[] · required

Search terms the campaign is told not to match.

Example:

["free", "repair"]

targeted_locations · GoogleAdsTargetedLocation · object[] · required

Locations the campaign targets.

Show child attributes

Example:

[
  {
    "name": "San Francisco",
    "resourceName": "geoTargetConstants/1014221"
  }
]

excluded_locations · GoogleAdsTargetedLocation · object[] · required

Locations the campaign excludes.

Show child attributes

Example:

[
  {
    "name": "Oakland",
    "resourceName": "geoTargetConstants/1014044"
  }
]

language_code · string · required

Two-letter code for the language the campaign advertises in. Defaults to en when the campaign has none set.

Example:

"en"

proximity · ProximityTarget · object | null

The radius the campaign serves within, around an address, instead of targeted_locations. Present only when radius targeting is enabled for the caller; null when the campaign targets places.

Show child attributes

Example:

{
  "city": "Austin",
  "country": "US",
  "postal_code": "",
  "radius": 10,
  "radius_units": "miles",
  "street": ""
}