v8

OpenAPI 3.1.02026-08-033623795.0 MB
Ad Groups

Estimate Ad Group Reach

Estimates how many people a draft targeting spec can reach, before an ad group is created. The body takes the same targeting fields as creating an ad group — regions, demographics, detailed_targeting, audiences, languages, and devices — and nothing is persisted.

post/ad_groups/estimate_reach

Headers

Idempotency-Keystring
Example:d9105228-4a08-46b1-8b91-42fed586d383

A unique key that makes this request safe to retry. See Idempotent requests.

Request body

account_idstring

Account to estimate on behalf of. Defaults to the authenticated account.

languagesstring[]

Languages to target, as ISO 639 codes such as en or es. Empty or omitted targets all languages.

platform'meta' required

The ad network the estimate runs on.

Response

reach estimated

users_lower_boundnumber nullable required

Low end of how many people the targeting can reach. Null when the platform couldn't produce an estimate.

users_upper_boundnumber nullable required

High end of how many people the targeting can reach. Null when the platform couldn't produce an estimate.