Zernio
Zernio
API Reference

Reach & Frequency

Create a Reach & Frequency predictionPOSTRead a Reach & Frequency predictionGETCancel a Reach & Frequency reservationDELETEReserve a Reach & Frequency predictionPOST
Dashboard
llms.txtOpenAPI
OverviewPlatformsAPI ReferenceResources
Reach & Frequency

Read a Reach & Frequency prediction

PlatformsMeta
GET
/v1/ads/rf-predictions/{predictionId}

Authorization

bearerAuth
AuthorizationBearer <token>

API key authentication - use your Zernio API key as a Bearer token

In: header

Path Parameters

predictionId*string

Query Parameters

accountId*string
adAccountId*string

Response Body

application/json

application/json

{  "adAccountId": "string",  "currency": "string",  "prediction": {    "predictionId": "string",    "status": "string",    "budget": 0,    "reach": 0,    "impressions": 0,    "minBudget": 0,    "maxBudget": 0,    "minReach": 0,    "maxReach": 0,    "frequencyCap": 0,    "startTime": 0,    "stopTime": 0,    "expiresAt": "string"  }}
Was this page helpful?

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.

Cancel a Reach & Frequency reservation

Releases a RESERVATION's locked price and inventory. Unreserved predictions expire on their own.