Get Delivery Estimate
adsap_get_delivery_estimateGet Meta's delivery estimate for a proposed audience and optimization configuration. Returns the estimated monthly audience range and an audience size assessment (too_narrow/narrow/moderate/broad/very_broad); Meta no longer returns daily reach or outcome curves. Sizes detailed targeting groups and demographics (targeting_spec.flexible_spec, the same shape adsap_create_ad_sets takes), so size an audience here before creating it; targeting_summary states the logic in words, e.g. (Cooking or Frequent Travelers) and Parents (All). Use during onboarding to validate strategies or in audits to check targeting breadth.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"ad_account_id": "<ad_account_id>",
"targeting_spec": "<targeting_spec>",
"optimization_goal": "<optimization_goal>"
},
"name": "adsap_get_delivery_estimate"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| daily_budget | No | Daily budget in cents. If provided, estimates are budget-constrained. | |
| ad_account_id | Yes | Must include act_ prefix. | |
| targeting_spec | Yes | Targeting specification. Must include at least countries. Detailed targeting and demographics go in flexible_spec groups (a top-level demographic key is rejected). Meta ANDs the separate interests and behaviors lists with each other. | |
| promoted_object | No | Required for conversion goals. E.g. { pixel_id: '123', custom_event_type: 'Purchase' } | |
| optimization_goal | Yes | Optimization goal for the estimate. |