Skip to main content

Audience Size

The Audience Size API returns an estimated range of potential reach for a given targeting spec.

By Ad Squad Spec​

 curl -X POST \
   -H "Content-Type: application/json" \
   -d '{"name": "App Install, United States, All Genders, 13-24", "status": "ACTIVE", "type": "SNAP_ADS", "targeting": {"geos": [{"country_code": "us"}],"demographics": [{"age_groups": ["13-17","18-20","21-24"]}]}, "placement": "CONTENT", "bid_micro": 6000000, "auto_bid": false, "daily_budget_micro": 50000000, "delivery_constraint": "DAILY_BUDGET", "optimization_goal": "APP_INSTALLS", "included_content_types": ["SCIENCE_TECHNOLOGY"]}' \
   -H "Authorization: Bearer meowmeowmeow" \
   https://adsapi.snapchat.com/v1/adaccounts/d8c1e7e9-f119-4ed3-b77e-33b7eae13411/audience_size_v2

The above command returns JSON structured like this:

{
  "request_status": "SUCCESS",
  "request_id": "5848847200ff049b9c18549b500001737e616473617069736300016275696c642d39323764616530622d312d32372d3300010124",
  "audience_size": {
    "audience_size_minimum": 15400000,
    "audience_size_maximum": 21025000
  }
}

HTTP Request​

POST https://adsapi.snapchat.com/v1/adaccounts/{ad_account_id}/audience_size_v2

URL Parameters​

ParameterDescription
ad_account_idAd Account ID

By Ad Squad ID​

Using the audience_size endpoint for getting the audience size is currently supported but will be deprecated in the future. Please update your calls to use audience_size_v2

curl -X GET
  -H "Content-Type: application/json"  \
  -H "Authorization: Bearer meowmeowmeow" \
  https://adsapi.snapchat.com/v1/adsquads/c7b98952-4c6e-4f95-8cd1-cf0f17a77988/audience_size_v2

The above command returns JSON structured like this:

{
  "request_status": "SUCCESS",
  "request_id": "58474ee700ff017f0381aeb1a90001737e616473617069736300016275696c642d32356261313161372d312d32372d3100010120",
  "audience_size": {
    "ad_squad_id": "c7b98952-4c6e-4f95-8cd1-cf0f17a77988",
    "audience_size_minimum": 16450000,
    "audience_size_maximum": 19925000
  }
}

This endpoint retrieves the estimated audience size for a specific ad squad.

HTTP Request​

GET https://adsapi.snapchat.com/v1/adsquads/{ad_squad_id}/audience_size_v2

URL Parameters​

ParameterDescription
ad_squad_idAd squad ID

By Targeting Spec​

This method of getting the audience size is currently supported but will be deprecated in the future. Please update your calls to use audience_size_v2 using Ad Squad ID or Ad Squad Spec

 curl -X POST \
   -H "Content-Type: application/json" \
   -d '{"geos":[{"country_code": "us"}], "demographics": [{"age_groups": ["21-24"]}]}' \
   -H "Authorization: Bearer meowmeowmeow" \
   https://adsapi.snapchat.com/v1/adaccounts/d8c1e7e9-f119-4ed3-b77e-33b7eae13411/audience_size

The above command returns JSON structured like this:

{
  "request_status": "SUCCESS",
  "request_id": "5848847200ff049b9c18549b500001737e616473617069736300016275696c642d39323764616530622d312d32372d3300010124",
  "audience_size": {
    "audience_size_minimum": 12400000,
    "audience_size_maximum": 15025000
  }
}

This endpoint retrieves the estimated audience size for a specific targeting spec, whether or not the targeting is in use by an ad squad.

HTTP Request​

POST https://adsapi.snapchat.com/v1/adaccounts/<ID>/audience_size

URL Parameters​

ParameterDescription
IDThe ID of the ad account
Was this page helpful?
Yes
No