list_audiences
List all audiences with subscriber counts, open/click rates, and opt-in settings. Obtain list IDs and audience details in a single request.
Instructions
List audiences (lists) with subscriber counts and engagement rates.
First step in most workflows to discover list_id values. Use get_audience_details for full stats of a known audience. Use search_members to find a specific member.
Args: count: Audiences to return (1-1000, default 10). Most accounts have fewer than 10. offset: Pagination offset. Use when total_items exceeds count.
Returns: JSON with total_items and audiences array. Each: id (use as list_id), name, member_count, unsubscribe_count, open_rate (0-1), click_rate (0-1), date_created, and the audience settings carried in the same list payload: campaign_defaults (default from_name, from_email, subject, language), double_optin (bool: true = confirmed/double opt-in), marketing_permissions (bool: GDPR permission fields enabled). These settings come free with this call -- the /lists endpoint returns each list's full object -- so all audiences and their opt-in/sender/compliance config are available in one request, without a get_audience_details call per audience.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | ||
| offset | No | ||
| account | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |