v2

latestOpenAPI 3.1.02026-08-075421692.0 MB

Reach and Frequency

Create a Reach & Frequency prediction

Creates an R&F prediction — a QUOTE, nothing is bought and no ad entities are created. Provide a date range plus exactly one of budgetAmount (Meta predicts reach) or reach (Meta predicts the budget). The response carries the estimate and its allowed bounds (min/max budget and reach). Predictions expire on their own; to buy, reserve one via POST /v1/ads/rf-predictions/{predictionId}/reserve and pass the RESERVED id to POST /v1/ads/create with buyingType: "RESERVED".

Reservation campaigns reject automatic placements. Top-level placements wins; when it is omitted, targeting.placements is used; when neither is set, placements default to Facebook feed (+ Instagram stream when a linked IG professional account resolves). Instagram placements require that IG account.

post/v1/ads/rf-predictions

Request body

accountIdstring required

Zernio SocialAccount id (posting or ads variant).

adAccountIdstring required

Meta ad account id (act_<n>).

budgetAmountnumber

Whole currency units. Exactly one of budgetAmount / reach.

reachinteger

Target unique reach. Exactly one of budgetAmount / reach.

startDatestring date-time required

Campaign window start (must be in the future).

endDatestring date-time required

frequencyCapinteger

Max impressions per person over the window.

targetingobject

Canonical camelCase TargetingSpec (same shape as /v1/ads/create's targeting). Defaults to countries: [US].

placementsobject

Meta placements object (same shape as /v1/ads/create's placements).

Response

Prediction created (usually ready within seconds)

adAccountIdstring

currencystring