Estimate audience size

GET

/api/v1/meta/audience/estimate

Executes the current audience size estimation flow using the supplied targeting payload. This route currently accepts a body on a GET request because that is how the runtime is implemented.

Request

Query Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Meta audience estimate result.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.adlyfy.dev/api/v1/meta/audience/estimate?adAccountId=undefined' \
--header 'x-api-key;' \
--header 'Content-Type: application/json' \
--data '{
    "targeting": {
        "geo_locations": {
            "countries": [
                "US"
            ]
        }
    },
    "optimizationGoal": "LINK_CLICKS"
}'

Response Example

200 - Example 1

{
    "success": true,
    "message": "Request successful",
    "timestamp": "2026-03-30T12:00:00.000Z",
    "statusCode": 200,
    "data": {
        "data": [
            {
                "estimate_ready": true,
                "estimate_mau_lower_bound": 8200000,
                "estimate_mau_upper_bound": 9700000
            }
        ]
    }
}

Create a lookalike audience

Search Meta targeting options