---
title: "get_matched_audiences. Metadata MCP tool reference"
url: https://metadata.io/developers/tools/get_matched_audiences
description: "Get matched audiences (custom audiences) from the Campaign Wizard based on audience type and targeting options. Read tool on the Metadata MCP server, with its full JSON Schema and a real recorded response."
source: metadata.io
---

# get_matched_audiences

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

Read [audiences](https://metadata.io/developers/tools/#cat-audiences)

## What it does

## Arguments

| Argument | Type |   | Notes |
|---|---|---|---|
| `type` | array | required | Array of audience targeting types to filter by. If omitted, searches all targeting types. |
| `channel` | string |   | The advertising channel to filter campaigns byone of: `LINKEDIN`, `FACEBOOK`, `GOOGLE_ADS`, `INSTAGRAM`, `TWITTER`, `YOUTUBE`, `REDDIT`, `MICROSOFT_ADS` |
| `page` | integer |   | Page number for pagination (0-indexed) |
| `sort` | string |   | Sort field and direction in format 'field,direction'. Common fields: createdDate. Direction: asc or desc. |
| `size` | integer |   | Number of results per page |

## Request

**Request template, not a complete runnable example.** Replace placeholders, empty objects, arrays, and zero values with valid account-specific inputs. Read required fields and nested constraints in the full schema. Confirm the account, connected channels, and referenced assets before calling a write tool.

## Response

Recorded with these arguments. Enum values are the first the tool's own schema declares; ids were fetched live from a `list_` call immediately before.

Real, from the production server, in **1954 ms**. The full response was 20,032 bytes; this is the first part of it. Values that identify a customer or disclose money are replaced with typed placeholders; keys, types and nesting are exactly as returned.

## Related

Other audiences tools:

- [archive_audience](https://metadata.io/developers/tools/archive_audience) Destructive
- [create_audience_from_segment](https://metadata.io/developers/tools/create_audience_from_segment) Writes
- [create_bombora_audience](https://metadata.io/developers/tools/create_bombora_audience) Writes
- [create_csv_upload_linkedin_native_audience](https://metadata.io/developers/tools/create_csv_upload_linkedin_native_audience) Writes
- [create_facebook_native_criteria_audience](https://metadata.io/developers/tools/create_facebook_native_criteria_audience) Writes
- [create_firmographic_audience](https://metadata.io/developers/tools/create_firmographic_audience) Writes
- [create_g2_intent_dynamic_audience](https://metadata.io/developers/tools/create_g2_intent_dynamic_audience) Writes
- [create_g2_intent_linkedin_native_dynamic_audience](https://metadata.io/developers/tools/create_g2_intent_linkedin_native_dynamic_audience) Writes

[Browse the tool catalog](https://metadata.io/developers/tools/) · [machine-readable index](https://metadata.io/developers/tools.json)