v8

OpenAPI 3.1.02026-08-033623795.0 MB

Audiences

List Audiences

Lists uploaded customer-list audiences for an account. Pass audience_id to return a specific audience.

get/audiences

Query parameters

account_idstring required

Account ID, prefixed biz_.

audience_idstring

Audience ID, prefixed adaud_, used to filter the response to one audience.

audience_type'custom' | 'lookalike'

Filter by audience type: custom (uploaded lists) or lookalike.

source_type'csv_upload' | 'people_filter'

Filter by member source: csv_upload (uploaded lists) or people_filter (automatic audiences built from saved People filters).

firstinteger

Number of audiences to return. Defaults to 20; maximum 100.

afterstring

Cursor for the next page of audiences.

Response

Audiences listed.

Example response

{
  "data": [
    {
      "audience_type": "custom",
      "match_rates": [
        {
          "platform": "meta",
          "status": "calculating"
        }
      ],
      "source_type": "csv_upload"
    }
  ]
}