Estimate a Google Ads campaign budget

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

Asks Google to forecast the clicks and spend a set of keyword themes would produce, so you can show a projection before a campaign is created.

Send the themes you are considering, as they would go to Create campaign. Nothing is saved.

Google's planner picks the budget it forecasts at — it does not take one — so the figures come back for Google's own recommended daily budget, which estimated_monthly_cost reports.

Google forecasts for a landing page in specific places, so a request without landing_page or without at least one geo_targets entry is rejected with a 400 before it reaches Google.

The forecast comes from Google's own planner, so it needs a connected Google Ads account that has finished provisioning. An account that exists but has no Google customer ID yet is rejected with a 400; wait for provisioning to finish and retry.

estimated_monthly_cost is in micros and covers 30 days.

<Note>Each call asks Google's planner, so this endpoint has its own quota of 10 requests per minute per app — separate from the AI pool. A 429 means that quota is spent; retry in a minute.</Note>

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

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

{
  "estimated_daily_clicks_low": 12,
  "estimated_daily_clicks_high": 31,
  "estimated_monthly_cost": 900000000
}