Bid Estimate

The Bid Estimate API returns a bid estimate min and max for a given Ad Squad or Targeting Spec.

Bid Estimate is available for the following optimization goals.

Optimization Goal	Bid Interpretation	Details
IMPRESSIONS	Cost Per 1000 Impressions (CPM)	bid_micro will not be exceeded
SWIPES	Target Cost Per Swipe	bid_micro is treated as a goal, not a maximum, and can be exceeded
APP_INSTALLS	Target Cost Per Install	bid_micro is treated as a goal, not a maximum, and can be exceeded
VIDEO_VIEWS	Target Cost per 2 second Video View	bid_micro is treated as a goal, not a maximum, and can be exceeded
USES	Cost Per Use (of filter)	bid_micro is treated as a goal, not a maximum, and can be exceeded
STORY_OPENS	Target Cost Per Story Open for Story Ads	bid_micro is treated as a goal, not a maximum, and can be exceeded
PIXEL_ADD_TO_CART	Target Cost Per ADD_TO_CART on web	bid_micro is treated as a goal, not a maximum, and can be exceeded
PIXEL_PAGE_VIEW	Target Cost Per PAGE_VIEW on web	bid_micro is treated as a goal, not a maximum, and can be exceeded
PIXEL_PURCHASE	Target Cost Per PURCHASE on web	bid_micro is treated as a goal, not a maximum, and can be exceeded
PIXEL_SIGNUP	Target Cost Per SIGNUP on web	bid_micro is treated as a goal, not a maximum, and can be exceeded
APP_ADD_TO_CART	Target Cost Per ADD_TO_CART on app	bid_micro is treated as a goal, not a maximum, and can be exceeded
APP_PURCHASE	Target Cost Per PURCHASE on app	bid_micro is treated as a goal, not a maximum, and can be exceeded
APP_SIGNUP	Target Cost Per PURCHASE on app	bid_micro is treated as a goal, not a maximum, and can be exceeded
APP_REENGAGE_OPEN	Target Cost Per App open	bid_micro is treated as a goal, not a maximum, and can be exceeded
APP_REENGAGE_PURCHASE	Target Cost Per App Purchase	bid_micro is treated as a goal, not a maximum, and can be exceeded

By Ad Squad

curl -X GET
  -H "Content-Type: application/json"  \
  -H "Authorization: Bearer meowmeowmeow" \
  https://adsapi.snapchat.com/v1/adsquads/c5995202-bfbc-45a0-9702-dd6841af52fe/bid_estimate

The above command returns JSON structured like this:

{
  "request_status": "success",
  "request_id": "57affee300ff0d91229fabb9710001737e616473617069736300016275696c642d35396264653638322d312d31312d3700010110",
  "bid_estimate": {
    "ad_squad_id": "c5995202-bfbc-45a0-9702-dd6841af52fe",
    "optimization_goal": "IMPRESSIONS",
    "bid_estimate_minimum": 8000000,
    "bid_estimate_maximum": 9000000
  }
}

This endpoint retrieves the bid estimate for a specific ad squad.

HTTP Request

GET https://adsapi.snapchat.com/v1/adsquads/<ID>/bid_estimate

URL Parameters

Parameter	Description
ID	The ID of the ad squad

By Targeting Spec

curl -X POST \
   -H 'Content-Type: application/json' \
   -d '{"optimization_goal": "IMPRESSIONS", "targeting": {"geos": [{"country_code": "us"}],"demographics": [{"age_groups": ["21-24"],"gender": "MALE"}]}}' \
   -H 'Authorization: Bearer meowmewmeow' \
   https://adsapi.snapchat.com/v1/adaccounts/8abc3db7-8148-4fbf-999c-8d2266369d75/bid_estimate

The above command returns JSON structured like this:

{
  "request_status": "success",
  "request_id": "57affee300ff0d91229fabb9710001737e616473617069736300016275696c642d35396264653638322d312d31312d3700010110",
  "bid_estimate": {
    "optimization_goal": "IMPRESSIONS",
    "bid_estimate_minimum": 8000000,
    "bid_estimate_maximum": 9000000
  }
}

This endpoint retrieves the bid estimate 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>/bid_estimate

URL Parameters

Parameter	Description
ID	The ID of the ad account

Attributes

Attribute	Description	Required	Note
optimization_goal	Optimization Goal	R	Available for all valid optimization goals
targeting	A valid Targeting Spec	R