Skip to main content
POST
Estimate Google Ads cost per click

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:""

Page the campaign sends clicks to, as an http or https URL. Google derives the keyword ideas it prices from this page. Required: anything else is rejected with a 400.

Example:

"https://example.com/furniture"

geo_targets
string[]

Locations to price clicks in, as Google geo target constant IDs (geoTargetConstants/1023191, or just 1023191). When you send more than 10, only 10 of them are priced, always the same 10 for the same set. Leave it empty to price all locations. If Google's keyword planner rejects the locations you send, the estimate covers all locations instead of failing.

Example:
language_code
string | null

Two-letter code of the language the ads run in, which picks the keyword market. A regional tag like pt-BR is reduced to pt, and a missing or unsupported code prices in English. List Google Ads advertising languages returns the supported codes.

Example:

"en"

Response

The estimated cost of one click.

What a click is likely to cost for a landing page in a set of locations.

cpc_low_micros
integer
required

Low end of the estimated cost of one click, in micros of currency_code, so 850000 is 0.85. 0 when there is no estimate.

Example:

850000

cpc_high_micros
integer
required

High end of the estimated cost of one click, in micros of currency_code. 0 when there is no estimate.

Example:

2400000

currency_code
string
required

Currency of both figures as a three-letter ISO 4217 code. It is the account's Google Ads budget currency, the same one campaign budgets are set in.

Example:

"USD"

sample_size
integer
required

How many of Google's keyword ideas the range is averaged over, at most 10. 0 means Google returned none it could price, so there is no estimate.

Example:

10