Get audience sizing

GET {{baseUrl}}/ad_accounts/:ad_account_id/ad_groups/audience_sizing

Get potential audience size for an ad group with given targeting criteria. Potential audience size estimates the number of people you may be able to reach per month with your campaign. It is based on historical advertising data and the targeting criteria you select. It does not guarantee results or take into account factors such as bid, budget, schedule, seasonality or product experiments.

Request Body

{"auto_targeting_enabled"=>true, "placement_group"=>"ALL", "creative_types"=>["VIDEO", "IDEA"], "targeting_spec"=>{"AGE_BUCKET"=>["18-24", "45-49"], "APPTYPE"=>["iphone", "android_mobile"], "AUDIENCE_EXCLUDE"=>["048", "016283"], "AUDIENCE_INCLUDE'"=>["81262434035", "15717068016"], "GENDER"=>["male", "male"], "GEO"=>["<string>", "<string>"], "INTEREST"=>["<string>", "<string>"], "LOCALE"=>["<string>", "<string>"], "LOCATION"=>["<string>", "<string>"], "SHOPPING_RETARGETING"=>[{"lookback_window"=>"<integer>", "tag_types"=>["<integer>", "<integer>"], "exclusion_window"=>"<integer>"}, {"lookback_window"=>"<integer>", "tag_types"=>["<integer>", "<integer>"], "exclusion_window"=>"<integer>"}], "TARGETING_STRATEGY"=>["CHOOSE_YOUR_OWN", "CHOOSE_YOUR_OWN"]}, "product_group_ids"=>["7324429", "17786615443"], "keywords"=>[{"match_type"=>"PHRASE", "value"=>"<string>"}, {"match_type"=>"PHRASE_NEGATIVE", "value"=>"<string>"}]}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring

RESPONSES

status: OK

{&quot;audience_size_lower_bound&quot;:&quot;\u003cnumber\u003e&quot;,&quot;audience_size_upper_bound&quot;:&quot;\u003cnumber\u003e&quot;}