Skip to main content
POST
Estimate a Google Ads campaign budget

Authorizations

Authorization
string
header
required

Personal access token, sent as Authorization: Bearer <token>.

Path Parameters

app_id
string
required

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

Body

application/json
landing_page
string
default:""

Landing page the campaign would send clicks to. Required for a forecast.

Example:

"https://example.com/furniture"

geo_targets
string[]

Locations to forecast for, as Google geo target constant IDs (geoTargetConstants/1023191, or just 1023191). At least one is required for a forecast.

Maximum array length: 50
Example:
keyword_themes
string[]

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

Maximum array length: 25
Example:
language_code
string
default:""

Two-letter language the ads would run in. Defaults to en.

Example:

"en"

business_name
string
default:""

Business name, which sharpens Google's forecast.

Example:

"Oakline Furniture"

daily_budget
integer
default:0

Daily budget you have in mind, in micros (1,000,000 micros = 1 unit of the account's currency). Google's planner chooses the budget it forecasts at, so this is only reported back when Google returns no recommendation of its own.

Example:

30000000

Response

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

Google's forecast for a set of keyword themes in a set of locations.

estimated_daily_clicks_low
integer
required

Low end of Google's forecast daily clicks.

Example:

12

estimated_daily_clicks_high
integer
required

High end of Google's forecast daily clicks.

Example:

31

estimated_monthly_cost
integer
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:

900000000