Audiences

List audiences for the caller's org

Returns non-deleted audiences for the org, newest first, a page at a time (limit default 25, max 100). Each row includes expanded segments / excluded_segments summaries (id, name, record_count, subtype) for its constituent segments — the same expansion as GET /v1/audiences/{id} — and the audience's campaign_id (null when unlinked). Filtered-out rows (archived unless include_archived, deleted, or excluded by campaign_id/unlinked) can leave a page with fewer than limit audiences; keep following next_cursor until it is null. Requires 'discovery' scope.

get/v1/audiences

Request

  • Base URL: https://api.infiniteaudience.ai
  • URL: https://api.infiniteaudience.ai/v1/audiences
  • Auth: HTTP bearer

Query parameters

include_archivedboolean

When true, archived audiences are included in results.

limitinteger

Number of results per page (max 100).

cursorstring

The next_cursor from the previous page.

campaign_idstring

Only audiences linked to this campaign, ordered by when each was linked (newest first) rather than by creation time. An unknown campaign is a 400 INVALID_CAMPAIGN_ID. Cannot be combined with unlinked. Its next_cursor is only valid with the same campaign_id (otherwise 400 INVALID_CURSOR), and stays valid when audiences are unlinked between pages.

unlinkedboolean

When true, only audiences that belong to no campaign. Cannot be combined with campaign_id (400 CONFLICTING_FILTERS).

Response

Paginated audience list.

totalinteger required

Number of audiences on this page.

next_cursorstring nullable required

Pass as cursor on the next request. Null when no further pages exist.

Changes

No recorded changes to this operation across all 1 revision of this API.