Audience Estimate

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.twitter.com/10/accounts/:account_id/audience_estimate

Parameters¶

Name Description

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. Note: this endpoint does not support the `operator_type` parameter

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.

Note: this endpoint does not support the operator_type parameter

Example Request¶

POST https://ads-api.twitter.com/10/accounts/18ce54d4x5t/audience_estimate

{
  "targeting_criteria": [
    {
      "targeting_type":"LOCATION",
      "targeting_value":"96683cc9126741d1"
    },
    {
      "targeting_type":"BROAD_KEYWORD",
      "targeting_value":"cats"
    },
    {
      "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": 41133600,
      "max": 50274400
    }
  }
}