Sign in

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 and the daily budget you have in mind, both as they would go to Create campaign. Nothing is saved.

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>This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.</Note>

post/api/apps/{app_id}/google-ads/campaigns/estimate

Path parameters

app_idstring required

ID of the app you are planning a Google Ads campaign for.

ID of the app you are planning a Google Ads campaign for.

Request body

keyword_themesstring[]

Themes the campaign would match on. An empty list forecasts nothing useful.

daily_budgetinteger

Daily budget to forecast against, in micros (1,000,000 micros = 1 unit of the account's currency).

Example request

{
  "keyword_themes": [
    "handmade oak furniture",
    "custom dining tables"
  ],
  "daily_budget": 30000000
}

Response

Google's forecast for the themes and budget you sent.

estimated_daily_clicks_lowinteger required

Low end of Google's forecast daily clicks.

estimated_daily_clicks_highinteger required

High end of Google's forecast daily clicks.

estimated_monthly_costinteger required

Forecast spend over 30 days, in micros (1,000,000 micros = 1 unit of the account's currency). This is the recommended daily budget times 30, so it is a 30-day figure rather than a calendar month, and it can differ from the daily_budget you sent.

Example response

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

Changes

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