Estimate Audience and Delivery
ads_estimate_deliveryAnswer “how big is this audience”: read Meta reach and delivery estimates for AdSpec targeting and an optimization goal. Does not create ads. Estimates are predictions, not guaranteed delivery. A 429 carries Retry-After. ROW_QUOTA_EXCEEDED carries the time the quota resets (meta.quota.resetsAt).
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": {
"accountId": "<accountId>",
"targeting": "<targeting>",
"optimizationGoal": "<optimizationGoal>"
},
"name": "ads_estimate_delivery"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fresh | No | Bypass the read cache. | |
| accountId | Yes | Ad account ID. | |
| targeting | Yes | AdSpec targeting shape, converted by the ad-creation builder. Include at least one location. No inherited source targeting is available for estimates. | |
| promotedObject | No | ||
| optimizationGoal | Yes |