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/8/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
    }
  }
}

Was this document helpful?

Thank you

Thank you for the feedback. We’re really glad we could help!

Thank you for the feedback. How could we improve this document?

Thank you for the feedback. Your comments will help us improve our documents in the future.