get_matched_audiences

Get matched audiences (custom audiences) from the Campaign Wizard based on audience type and targeting options.

                        Retrieves custom audiences that match specific targeting configurations.
                        Use this to find available audiences for campaign targeting on a given advertising channel.
                        This is the canonical tool to call when you need an audience id to attach to a campaign or a target group's include[].audiences / exclude.audiences arrays. The returned id/name/type/matchCount/inactive fields are exactly the shape those payloads expect. It draws on the same source the main UI's target-group audience-chooser uses, so what this tool returns is what the platform considers attachable.

                        AUDIENCE TARGETING TYPES AVAILABLE:
                        • FIRMOGRAPHIC_INCLUDE: Firmographic inclusion filters (company size, industry, location)
                        • FIRMOGRAPHIC_EXCLUDE: Firmographic exclusion filters
                        • FIRMOGRAPHIC_EXCLUDE_BASIC: Basic firmographic exclusions
                        • FIRMOGRAPHIC_INCLUDE_SFDC: Salesforce firmographic inclusions
                        • NATIVE_TARGETING_CSV: CSV-based native targeting
                        • NATIVE_TARGETING_DYNAMIC: Dynamic native targeting lists
                        • NATIVE_TARGETING_STATIC: Static native targeting lists
                        • CONTACT_LIST: Custom contact list targeting
                        • STORELEADS: Store leads targeting
                        • DYNAMIC_G2: Dynamic G2 crowd data
                        • DYNAMIC_G2_CONTACT: Dynamic G2 contact data
                        • G2_ABM_CONTACT: G2 ABM contact targeting
                        • LEADSIFT: LeadSift intent data targeting
                        • BUYER_INTENT: Buyer intent data targeting
                        • MA_ACCOUNTS_STATIC: Marketing automation static accounts
                        • MA_ACCOUNTS_DYNAMIC: Marketing automation dynamic accounts
                        • MA_CONTACTS_STATIC: Marketing automation static contacts
                        • MA_CONTACTS_DYNAMIC: Marketing automation dynamic contacts
                        • NATIVE_LINKEDIN: Native LinkedIn targeting options
                        • LINKEDIN_RETARGETING: LinkedIn retargeting audiences
                        • SFDC_CONTACTS_DYNAMIC: Salesforce dynamic contacts
                        • SFDC_CONTACTS_STATIC: Salesforce static contacts
                        • SFDC_ACCOUNT_DYNAMIC: Salesforce dynamic accounts
                        • WEBSITE_RETARGETING: Website visitor retargeting
                        • WEBSITE_ACCOUNT_RETARGETING: Website account-based retargeting
                        • TECHNOLOGY: Technology stack targeting
                        • SLINTEL_TECHNOLOGY: Slintel technology targeting

                        COMMON USE CASES:
                        - Find all LinkedIn audiences using firmographic targeting
                        - Get audiences with website retargeting enabled
                        - List audiences using G2 intent data
                        - Search for audiences with Salesforce integration
                        - Identify audiences using specific MA platforms
                        - Find dynamic vs static audience configurations
                        - Discover available contact lists and store leads

                        PARAMETERS:
                        - type: Array of targeting types to match (defaults to all types if not specified)
                        - channel: Advertising channel (LINKEDIN, FACEBOOK, GOOGLE_ADS, INSTAGRAM, TWITTER, YOUTUBE, REDDIT, MICROSOFT_ADS)
                        - page: Page number for pagination (0-indexed)
                        - sort: Sort field and direction (e.g., 'createdDate,desc', 'name,asc')
                        - size: Number of results per page (1-200)

                        RETURNS:
                        Paginated list of custom audiences matching the specified targeting criteria.
                        Each audience includes:
                        - id: Audience ID
                        - name: Audience name
                        - matchCount: Number of matches in the audience
                        - type: Targeting type (e.g., FIRMOGRAPHIC_INCLUDE, MA_CONTACTS_DYNAMIC)
                        - channel: Channel the audience is for
                        - createdDate: When the audience was created
                        - inactive: Whether the audience is active or inactive
                        - tags: Associated tags