Audiences

List Audiences

Search and browse all GTM Studio audiences. The primary way to discover an audienceId before loading rows, managing columns, or triggering enrichment. Also use this to check what audiences already exist before creating a duplicate.

Filters:

  • filter[type]: CONTACT or COMPANY
  • filter[searchText]: case-insensitive partial match on audience name

Sorting: sort accepts name, createdAt, updatedAt, or recordCount. Prefix with - for descending order. Default: -updatedAt.

Pagination: page[number] (default 1) and page[size] (default 25, max 100).

Returns 200 with a paginated list of audience resources and navigation links. Returns 400 if filter or sort parameters are invalid.

get/studio/v1/audiences

Request

  • Base URL
    https://api.zoominfo.com/gtm
  • URL
    https://api.zoominfo.com/gtm/studio/v1/audiences
  • Auth
    OAuth 2
    Authorization code: https://login.zoominfo.com
    Token URL: https://okta-login.zoominfo.com/oauth2/default/v1/token scopes: api:audience:read

Query parameters

page[number]integer

Page number for the results.

page[size]integer

Number of records to return per page. Default is 25.

sortstring

Field based on which to sort the results. Use '-' prefix for descending order. Allowed values: name, createdAt, updatedAt, recordCount

filter[type]'CONTACT' | 'COMPANY'

Determines the record type the audience holds. Set at creation and cannot be changed.

Filter audiences by record type. CONTACT for person-level records; COMPANY for account-level records.

filter[searchText]string

Search audiences by name using a case-insensitive contains match.

Response

Success

Changes

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