Reach and Frequency

Create reach-frequency prediction

Changed on

Quotes the reach or budget for a Meta reach and frequency campaign over a date range, without buying anything.

This is 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

  • Base URL: https://zernio.com/api
  • URL: https://zernio.com/api/v1/ads/rf-predictions
  • Auth: HTTP bearer

Request body

accountIdstring required

Zernio SocialAccount id (posting or ads variant).

adAccountIdstring required

Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...).

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

Changes

  • 450ec6ec5b0eRevision changes
    • info

      added the non-success response with the status

  • f8c8f34fb41aRevision changes
    • warning

      added the new account enum value to the / response property for the response status

    • warning

      added the new account enum value to the / response property for the response status

    • warning

      added the new account enum value to the / response property for the response status