Audience Estimate
audience-estimate

Audience Estimate

POST accounts/:account_id/audience_estimate

Determine the approximate audience size of your campaigns.

This endpoint accepts an array of JSON objects containing the parameters for the targeting criteria objects. A list of required and optional targeting criteria parameters are available on the POST accounts/:account_id/targeting_criteria endpoint. Requests must be HTTP POST with a JSON content body with a Content-Type: application/json header.

Note: It is required that you specify at least one primary targeting criterion; you can see a list of all primary targeting criteria in our campaigns targeting page.

Resource URL

https://ads-api.x.com/12/accounts/:account_id/audience_estimate

Parameters

Name Description
account_id
required

The identifier for the leveraged account. Appears within the resource's path and is generally a required parameter for all Advertiser API requests excluding GET accounts. The specified account must be associated with the authenticated user.

Type: string

Example: 18ce54d4x5t

targeting_criteria
required

A JSON object containing all the parameters for the targeting criteria objects. A list of required and optional targeting criteria parameters are available on the POST accounts/:account_id/targeting_criteria endpoint.

operator_type
optional

Specify the relationship that the targeting criterion should have. For example, to set negated targeting, use operator_type=NE.

Type: enum

Possible values: EQ, NE

Default: EQ

Example Request

POST https://ads-api.x.com/12/accounts/18ce54d4x5t/audience_estimate

{
    "targeting_criteria": [
        {
            "targeting_type": "BROAD_KEYWORD",
            "targeting_value": "nba",
            "operator_type": "EQ"
        },
        {
            "targeting_type": "BROAD_KEYWORD",
            "targeting_value": "tech",
            "operator_type": "NE"
        },
        {
            "targeting_type": "LOCATION",
            "targeting_value": "96683cc9126741d1",
            "operator_type": "EQ"
        },
        {
            "targeting_type": "SIMILAR_TO_FOLLOWERS_OF_USER",
            "targeting_value": "14230524"
        },
        {
            "targeting_type": "SIMILAR_TO_FOLLOWERS_OF_USER",
            "targeting_value": "90420314"
        }
    ]
}

Example Response

{
  "request": {
    "params": {
      "targeting_criteria": null,
      "account_id": "18ce54d4x5t"
    }
  },
  "data": {
    "audience_size": {
      "min": 38236294,
      "max": 42261167
    }
  }
}