API ReferenceAnnouncementsCommunity Discussion
API ReferenceCommunity DiscussionAnnouncementsSubscribeLog In
API Reference

Get All Custom Audiences

Get a list of all Custom Audiences, for the specified account.
Returns all audiences available to that account - including audiences created at the network level.

📘

Returns all audiences available to that account - including audiences created at the network level.

📘

Custom Audiences are not specific to a given campaign - they are defined at the account level.

{
   "results": [
      {
         "id": 201,
         "display_name": "Lead3",
         "look_back_window": 20,
         "category": "LEAD",
         "status": "DISABLED",
         "type": "EVENT_BASED",
         "event_name": "lead3",
         "condition": {
            "property": null,
            "predicate": null,
            "value": null,
            "children": null
         },
         "effects": [],
         "include_in_total_conversions": true,
         "exclude_from_campaigns": false,
         "description": null,
         "advertiser_id": "demo-advertiser",
         "last_modified_by": "[email protected]",
         "last_modified_at": "2018-11-07"
      },
      {
         "id": 64,
         "display_name": "long",
         "look_back_window": null,
         "category": "COMPLETE_REGISTRATION",
         "status": "ACTIVE",
         "type": "BASIC",
         "event_name": "page_view",
         "condition": {
            "property": null,
            "predicate": "OR",
            "value": null,
            "children": [
               {
                  "property": "URL",
                  "predicate": "CONTAINS",
                  "value": "dd",
                  "children": []
               },
               {
                  "property": "URL",
                  "predicate": "CONTAINS",
                  "value": "ff",
                  "children": []
               }
            ]
         },
         "effects": [],
         "include_in_total_conversions": true,
         "exclude_from_campaigns": false,
         "description": null,
         "advertiser_id": "demo-advertiser",
         "last_modified_by": "[email protected]",
         "last_modified_at": "2017-12-30"
      }
   ]
}

📘

Response Body

The response body is a valid, JSON object, with a results property that contains the list of Custom Audiences.

Language