Sign in
latestOpenAPI 3.1.02026-08-153864115.7 MB

c301132dbfd7

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": "lookalike",
      "created_at": "2026-01-01T12:00:00.000Z",
      "error_message": "412 of 1,000 rows had no email or phone number, so the list could not be matched.",
      "filters": {
        "country": "US",
        "last_seen_within_days": 30
      },
      "id": "adaud_xxxxxxxxxxxxxx",
      "last_refreshed_at": "2026-01-01T12:00:00.000Z",
      "lookalike_ratio": 0.04,
      "lookalike_starting_ratio": 0.02,
      "match_rates": [
        {
          "lower_bound": 40,
          "platform": "meta",
          "status": "available",
          "upper_bound": 50
        }
      ],
      "name": "Past purchasers Lookalike 2–4%",
      "platform_audience_ids": [
        "120246230799130687"
      ],
      "source_audience_id": "adaud_xxxxxxxxxxxxxx",
      "source_type": "csv_upload",
      "updated_at": "2026-01-01T12:00:00.000Z"
    }
  ],
  "page_info": {
    "end_cursor": "WyJjdXJzb3IiLDFd",
    "start_cursor": "WyJjdXJzb3IiLDFd"
  }
}