Ad Targeting

Estimate audience reach

Changed on

Estimates how many people a targeting setup would reach before you create a campaign.

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

  • Base URL: https://zernio.com/api
  • URL: https://zernio.com/api/v1/ads/targeting/reach-estimate
  • Auth: HTTP bearer

Request body

accountIdstring required

Zernio 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.

activeinteger nullable

LinkedIn only. LinkedIn's audienceCounts.active, verbatim: the active subset of the same audience lower/upper carry as its total. Absent when LinkedIn does not report it; 0 is a real answer, not a missing one.

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.

Changes

  • c6dd037b213dRevision changes
    • info

      added the new optional request property /////

  • 27c96850cc66Revision changes
    • info

      added the new optional request property /////

    • info

      added the new optional request property /////

    • info

      added the new optional request property /////

    • info

      added the new optional request property /////