Sign in

v2

latestOpenAPI 3.1.02026-08-075421692.0 MB
Ad Targeting

Estimate audience reach

Returns a normalized pre-flight audience-size estimate for a targeting spec, before any campaign is created. Backed by each platform's native reach API (Meta delivery_estimate, LinkedIn audienceCounts, X audience_summary, Pinterest audience_sizing).

Platforms without a usable pre-flight reach API (Google Search/Display, TikTok) return available: false with no bounds, so clients can hide or grey out the estimate rather than treat the absence as an error.

post/v1/ads/targeting/reach-estimate

Request body

accountIdstring required

Zernio social account ID on the target ad platform (the estimate runs against its platform).

adAccountIdstring required

Required. The platform ad-account ID the reach call runs against (Meta act_..., LinkedIn numeric sponsoredAccount ID, Pinterest ad-account ID, X account ID) - every backing reach API is scoped to one ad account. Get it from GET /v1/ads/accounts.

optimizationGoalstring

Optional. The optimization goal the estimate should assume (platform's own vocabulary, e.g. Meta REACH, LINK_CLICKS, OFFSITE_CONVERSIONS). Some platforms vary the estimate by goal; omit to use the platform default.

Response

Normalized reach estimate

availableboolean required

Whether a pre-flight estimate is available on this platform. False for Google and TikTok.

lowerinteger nullable

Lower bound of the estimated reachable audience. Present only when available.

upperinteger nullable

Upper bound of the estimated reachable audience. Present only when available.

dailyinteger nullable

Optional estimated daily reach/results at the given budget, when the platform returns it.

currencystring nullable

Currency of any monetary fields in the estimate, when applicable.

estimateReadyboolean nullable

Meta only. False when Meta is still computing the estimate (the audience is too new); retry shortly.