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

Asks Google's Smart campaign planner for a low, a recommended and a high daily budget for a set of keyword themes, each with its daily click forecast.

The response is Google's own answer, passed through as Google sends it. That is why its fields are camelCase and its numbers are strings, unlike the rest of this API, and why a value of 0 is left out rather than sent. Any tier can be missing. Estimate a Google Ads campaign budget makes the same planner call and returns one recommended forecast in this API's usual shape, so prefer it unless you need all three tiers.

Google needs a landing page and at least one location, so a request without an http or https landing_page or without a usable geo_targets entry is rejected with a 400 before it reaches Google. Entries in geo_targets that are not geo target constant IDs are dropped. Nothing is saved.

The app needs a connected Google Ads account that has finished provisioning. Check that google_customer_id in Get Google Ads account is not empty before you call this.

This shares a quota of 10 requests a minute per app with Estimate a Google Ads campaign budget. Some workspaces have a different limit. It is refused with a 409 while the workspace is on a Google Ads billing hold.

<Note>This endpoint accepts a personal API key from anyone who can edit the app. A read-only key is refused with a 403, and so are workspace API keys.</Note>

<Warning>The response includes fields beyond the ones documented here. Don't rely on undocumented response fields, as they can change at any time. Send only the fields documented here. Other request fields are not supported and their behavior can change.</Warning>

{
  "keyword_themes": [
    "handmade oak furniture",
    "custom dining tables"
  ],
  "landing_page": "https://example.com/furniture",
  "geo_targets": [
    "1023191"
  ],
  "language_code": "en",
  "business_name": "Oakline Furniture"
}

{
  "low": {
    "dailyAmountMicros": "30000000",
    "metrics": {
      "minDailyClicks": "12",
      "maxDailyClicks": "31"
    }
  },
  "recommended": {
    "dailyAmountMicros": "30000000",
    "metrics": {
      "minDailyClicks": "12",
      "maxDailyClicks": "31"
    }
  },
  "high": {
    "dailyAmountMicros": "30000000",
    "metrics": {
      "minDailyClicks": "12",
      "maxDailyClicks": "31"
    }
  }
}