estimate_audience_size
Estimate audience size for Meta Ads campaigns using detailed targeting specifications. Analyze demographics, geography, interests, and behaviors to validate and predict reach, link clicks, impressions, or conversions.
Instructions
Estimate audience size for targeting specifications using Meta's delivery_estimate API.
This function provides comprehensive audience estimation for complex targeting combinations
including demographics, geography, interests, and behaviors. It also maintains backwards
compatibility for simple interest validation.
Args:
access_token: Meta API access token (optional - will use cached token if not provided)
account_id: Meta Ads account ID (format: act_XXXXXXXXX) - required for comprehensive estimation
targeting: Complete targeting specification including demographics, geography, interests, etc.
Example: {
"age_min": 25,
"age_max": 65,
"geo_locations": {"countries": ["PL"]},
"flexible_spec": [
{"interests": [{"id": "6003371567474"}]},
{"interests": [{"id": "6003462346642"}]}
]
}
optimization_goal: Optimization goal for estimation (default: "REACH").
Options: "REACH", "LINK_CLICKS", "IMPRESSIONS", "CONVERSIONS", etc.
interest_list: [DEPRECATED - for backwards compatibility] List of interest names to validate
interest_fbid_list: [DEPRECATED - for backwards compatibility] List of interest IDs to validate
Returns:
JSON string with audience estimation results including estimated_audience_size,
reach_estimate, and targeting validation
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| access_token | No | ||
| account_id | No | ||
| interest_fbid_list | No | ||
| interest_list | No | ||
| optimization_goal | No | REACH | |
| targeting | No |
Input Schema (JSON Schema)
{
"properties": {
"access_token": {
"default": null,
"title": "Access Token",
"type": "string"
},
"account_id": {
"default": null,
"title": "Account Id",
"type": "string"
},
"interest_fbid_list": {
"default": null,
"items": {
"type": "string"
},
"title": "Interest Fbid List",
"type": "array"
},
"interest_list": {
"default": null,
"items": {
"type": "string"
},
"title": "Interest List",
"type": "array"
},
"optimization_goal": {
"default": "REACH",
"title": "Optimization Goal",
"type": "string"
},
"targeting": {
"additionalProperties": true,
"default": null,
"title": "Targeting",
"type": "object"
}
},
"title": "estimate_audience_sizeArguments",
"type": "object"
}