Skip to main content
POST
Return Google Ads ad traffic impression, click, cost, CTR, and average CPC forecasts

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key
string

Optional key for safely retrying a billable write request.

Required string length: 1 - 255

Body

application/json
bid
integer
required
keywords
string[]
required
Required array length: 1 - 100 elements
Required string length: 1 - 100
match
enum<string>
required
Available options:
exact,
broad,
phrase
date_from
string<date>
date_interval
enum<string>
Available options:
next_week,
next_month,
next_quarter
date_to
string<date>
language_code
string
location_code
integer
search_partners
boolean

Response

Historical ad traffic metrics.

items
object[]
required