Campaign Reach Estimator

  • Estimates the reach (total impressions) of a given campaign.
  • Estimates are based on historical data for similar campaign targeting.
Rate limit: Tier 2
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
🚧

Request object

  1. A JSON object with the relevant campaign fields.
  2. The minimal set of fields are:
    1. country_targeting
    2. platform_targeting
  3. For more accurate results, pass additional fields.
🚧

Guidelines

  1. Leaving out the minimal fields (above) will generate an unrealistically broad estimate. (However, the system does not validate for their presence.)
  2. You can pass all available fields. Fields that do not affect the reach estimate - e.g. postal_code_targeting - will simply be ignored.
  3. 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.)

Rate limit

🚧

Rate limit

Tier 2. The reach estimator has its own budget, separate from the campaign endpoints.

See Rate limits for the request allowance each tier carries.

Path Params
string
required

An alphabetic ID. See Get Account Details.

Body Params
json

A JSON object with the relevant campaign fields.

Responses

Language
Credentials
OAuth2
LoadingLoading…
Response
Choose an example:
application/json