audiences
List audiences
Get list of audiences for the ad account.
get/ad_accounts/{ad_account_id}/audiences
Path parameters
ad_account_idstring required
Unique identifier of an ad account.
Query parameters
bookmarkstring
Cursor used to fetch the next page of items
page_sizeinteger
Maximum number of items to include in a single page. See documentation on Pagination for more information.
order'ASCENDING' | 'DESCENDING'
The order in which to sort the items returned: "ASCENDING" or "DESCENDING" by ID. Note that higher-value IDs are associated with more-recently added items.
ownership_type'OWNED' | 'RECEIVED'
Filter audiences by ownership type.
exclude_ncaboolean
When true, excludes audiences derived from new customer acquisition (expanded matching) customer lists from the result. Defaults to false (include all).
Response
The request has succeeded.
Example response
{
"items": [
{
"audience_type": "ACTALIKE",
"rule": {
"event_data": {
"lead_type": "Newsletter",
"line_items": {
"product_brand": "Parker",
"product_category": "Shoes",
"product_id": 1414,
"product_name": "Parker Boots",
"product_price": "99.99",
"product_quantity": 2,
"product_variant": "Red",
"product_variant_id": "1414-34832"
},
"order_id": "X-151481",
"order_quantity": 1,
"page_name": "Our Favorite Pins on Pinterest",
"promo_code": "WINTER10",
"property": "Athleta",
"search_query": "boots",
"value": "199.98",
"video_title": "How to style your Parker Boots"
}
}
}
]
}