---
title: "Estimate the addressable audience"
method: POST
path: "/ads-management/v1/audience-estimates"
---

# Estimate the addressable audience

`POST /ads-management/v1/audience-estimates`

## Request

- Base URL: `https://apis.roblox.com`
- URL: `https://apis.roblox.com/ads-management/v1/audience-estimates`
- Auth: one of:
  - API key in cookie `.ROBLOSECURITY`
  - API key in header `x-api-key`
  - OAuth 2
    - Authorization code: `https://apis.roblox.com/oauth/v1/authorize`
    - Token URL: `https://apis.roblox.com/oauth/v1/token` scopes: `ad.campaign:read`

Returns a non-binding range of users reachable with the proposed targeting. campaignContext has the same shape as performance estimates, but accepts every creatable objective (PLAYS, ENGAGEMENT, ROBUX_SPEND). targeting accepts the same values and combinations as CreateCampaign, including regions.

## Request body

- AudienceEstimateRequest
  - `campaignContext` PlanningCampaignContext, required
    - `objective` 'PLAYS' | 'ENGAGEMENT' | 'ROBUX_SPEND', required: The advertising goal. Can be `PLAYS`, `ENGAGEMENT`, or `ROBUX_SPEND`.
    - `targetUniverseId` string, required: The experience to plan for, as a decimal string.
    - `targeting` Targeting
      - `ageGroups` string[]: The age brackets to deliver to. Empty means all ages. Values can be `AGE_13_17`, `AGE_18_24`, or `AGE_25_PLUS`.
      - `audienceType` 'ALL_PLAYERS' | 'NEW_USERS' | 'RETENTION' | 'REACTIVATION': Omitted or `ALL_PLAYERS` delivers to all players. Other values restrict delivery to a retargeting audience of the target experience. For `ENGAGEMENT`, only omission or `ALL_PLAYERS` is accepted; other targeting fields are rejected. Responses always include the resolved value.
      - `countries` string[]: The ISO 3166-1 alpha-2 country codes to deliver to (for example, `US`). Empty means all countries. Use this field to target single countries. Can't be combined with the region `ALL`, or with the region that contains the country.
      - `devices` string[]: The device types to deliver to. Empty means all devices. Values can be `PHONE`, `TABLET`, `DESKTOP`, or `CONSOLE`.
      - `regions` string[]: The aggregate geographic regions to deliver to, or `ALL`. Empty means all regions. Use only the values in campaign-options `targetingDimensions.regions`. `ALL` can't be combined with other regions or with countries.

## Response `200`

OK

- AudienceEstimateResponse
  - `lowerBound` integer, required: Estimated lower bound of reachable users.
  - `upperBound` integer, required: Estimated upper bound of reachable users.

## Other responses

- `400`: Invalid request
- `403`: Permission denied
- `429`: Rate limit exceeded
- `500`: Internal server error

## Changes

- **2026-11-16** `a94d3bd77d7f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/roblox/apis/roblox-api/changes/ads-management/v1/audience-estimates/post.md)

---

[API](https://skmtc.dev/roblox/apis/roblox-api.md) - [All operations](https://skmtc.dev/roblox/apis/roblox-api/llms.txt) - [OpenAPI document](https://skmtc.dev/roblox/apis/roblox-api/revisions/a94d3bd77d7f?raw)
