Discard
GuidesAPI ReferenceChangelogDiscussions
GuidesAPI ReferenceChangelogDiscussionsLog In

Get Existing Audiences

Retrieving Audiences for a Specific Advertiser

Audiences created through Criteo's API will be returned for the designated advertiser ID.

https://api.criteo.com/2021-10/audiences?advertiser-id={advertiserId}

 

The API will return an array of the IDs, names, description, date of creation, date of last update, number of lines in the contact list, as well as the number of matched emails in the contact list associated with the specified advertiser ID. Please note that the advertiser ID is required in the request URL.

{
  "data": [
    {
      "type": "AudienceContactlist",
      "id": "1",
      "attributes": {
        "advertiserId": "18",
        "name": "Audience name",
        "description": "An Audience description",
        "createdAt": "2020-10-20T08:35:22.000Z",
        "updatedAt": "2020-10-20T08:35:22.000Z",
        "nbLines": 100,
        "nbLinesEmail": 10,
        "nbMatchesEmail": 10
      }
    }
  ],
    "errors": [],
    "warnings": []
}

What’s Next

Learn how to create audiences and update audience metadata

Did this page help you?