Examples

Example 1:

POST /2.0/json/{account_id}/campaign/reach_estimator HTTP/1.1
Host: accessrequest.taboola.com  
Content-Type: application/json
Authorization: Bearer {access_token}

{
    "country_targeting": {
        "type": "INCLUDE",
        "value": [
            "US",
            "IL"
        ],
        "href": null
    },
    "platform_targeting": {
        "type": "ALL",
        "value": [
            "DESK",
            "TBLT"
        ],
        "href": null
    }
}

{
    "lower_bound": 918139521,
    "upper_bound": 983372274,
    "is_budget_depleted": null
}

Example 2:

POST /2.0/json/{account_id}/campaign/reach_estimator HTTP/1.1
Host: accessrequest.taboola.com  
Content-Type: application/json
Authorization: Bearer {access_token}

{
    "country_targeting": {
        "type": "INCLUDE",
        "value": [
            "DE"
        ]
    },
    "platform_targeting": {
        "type": "INCLUDE",
        "value": [
            "DESK"
        ]
    },
    "audience_segments_multi_targeting": {
    	"value": [
    	{
	        "type": "INCLUDE",
	        "value": [
	        22183902
	        ],
	        "href": null
	    }
	   ]
	},
    "external_brand_safety": {
        "type": "DV",
        "values": [
            {
                "category_name": "Ad Server",
                "risk_level": "HIGH",
                "id": null
            }
        ]
    }
}

{
    "lower_bound": 1000000000,
    "upper_bound": 1000000001,
    "is_budget_depleted": null
}

🚧
Request object

A JSON object with the relevant campaign fields.

The minimal set of fields are:

country_targeting

platform_targeting

For more accurate results, pass additional fields.

🚧
Guidelines

Leaving out the minimal fields (above) will generate an unrealistically broad estimate. (However, the system does not validate for their presence.)

You can pass all available fields. Fields that do not affect the reach estimate - e.g. postal_code_targeting - will simply be ignored.

Note that campaign budget and scheduling do not affect the estimate.

📘
Response object

lower_bound - estimated lower bound for monthly impressions.

Max value = 1000,000,000

upper_bound - estimated upper bound for monthly impressions.

Max value = 1000,000,001

is_budget_depleted - used for special cases only.

(You can ignore this field.)

estimation_type - "IMPRESSIONS" or "MONTHLY_USERS"