Meta Ads / API Reference
meta_ads_reach_frequency_prediction
Meta Ads tool. Get Reach & Frequency prediction for a campaign before buying. Returns estimated reach, impressions, frequency, and CPM for a given audience + budget + date range. Use this before launching a branding campaign. Args: account_id: Ad account ID. Leave blank for .env default. start_time: Start time as Unix timestamp string (e.g. '1735689600'). end_time: End time as Unix timestamp string. budget: Total budget in account currency smallest unit (cents/agorot). target_spec: JSON targeting spec (same as adset targeting). Example: '{"geo_locations":{"countries":["IL"]},"age_min":25,"age_max":45}' prediction_mode: 0=BASIC (budget→reach), 1=EXPERT (reach→budget). Default: 0. objective: REACH or BRAND_AWARENESS. Default: REACH. frequency_cap: Max impressions per user (e.g. '3'). interval_frequency_cap_reset_period: Hours for frequency cap reset (e.g. '168' for weekly).
This is a read-only tool: it returns reach frequency prediction for your Meta Ads account. It changes nothing.
Ask Claude
You do not call this tool yourself. Ask for the outcome and the client picks the tool:
Reach frequency prediction in my Meta Ads account for [start time], [end time], [budget].
It takes 5 required and 4 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
account_id | string | Yes | Account Id |
start_time | string | Yes | Start Time |
end_time | string | Yes | End Time |
budget | string | Yes | Budget |
target_spec | string | Yes | Target Spec |
prediction_mode | string | No | Prediction Mode |
objective | string | No | Objective |
frequency_cap | string | No | Frequency Cap |
interval_frequency_cap_reset_period | string | No | Interval Frequency Cap Reset Period |
Related Meta Ads tools
meta_ads_reach_estimatemeta_ads_ab_test_resultsmeta_ads_account_change_historymeta_ads_account_diagnosticsmeta_ads_account_spending_limitmeta_ads_ad
Before you can call it
This tool needs a connected Meta Ads account. The Meta Ads connect guide covers the OAuth flow and the permissions it asks for, and the quickstart gets a client talking to the server in about five minutes.
Workflows that use this
Rather than calling tools one at a time, these skills run a whole procedure against the same account: