Audience Summary

POST accounts/:account_id/audience_summary

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

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.

Note: this endpoint does not support the operator_type parameter

Example Request

POST https://ads-api.twitter.com/6/accounts/18ce54d4x5t/audience_summary

{
  "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
    }
  }
}