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/9/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: |
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 |
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
}
}
}