MMetadata /docs
⌘K
Docs/Tools/get_retargeting_audiences

get_retargeting_audiences

Get all available retargeting audiences for a specific advertising channel.

Read audiences

Returns data. Calling it changes nothing, so it is safe in an unattended loop.

What it does

Get all available retargeting audiences for a specific advertising channel.

                This tool retrieves all retargeting audiences and native audiences available for the specified
                advertising channel (GOOGLE_ADS, LINKEDIN, or FACEBOOK) that can be used to create new retargeting
                audiences. This is useful when you need to discover existing audiences before creating or targeting them.

                SUPPORTED CHANNELS:
                - GOOGLE_ADS: Google Ads retargeting audiences
                - LINKEDIN: LinkedIn retargeting audiences
                - FACEBOOK: Facebook retargeting audiences

                WHEN TO USE:
                - Discover all available retargeting audiences for a specific channel
                - View native audiences that can be used for targeting on a channel
                - Find audience IDs and details for audience creation or targeting
                - Review audience names, sizes (matchCount), and other metadata
                - Understand what audiences are available before building campaigns
                - Compare audiences across different advertising channels

                PARAMETERS:
                - channel: The advertising channel to fetch retargeting audiences for (required)
                  Options: GOOGLE_ADS, LINKEDIN, FACEBOOK
                  Note: Channel names are case-insensitive and will be converted to uppercase

                RETURNS:
                List of available retargeting and native audiences with details including:
                - id: Unique audience ID
                - name: Audience name
                - type: Audience type (e.g., GoogleAdsAudience, LinkedInAudience, FacebookAudience)
                - subtype: Audience subtype (e.g., GOOGLE_ADS_RETARGETING, LINKEDIN_RETARGETING)
                - channel: Channel type identifier
                - matchCount: Number of matches/members in the audience
                - externalAccountId: Associated account ID on the advertising platform
                - seedSourcePlatform: Source platform for the audience seed

                AUDIENCE DETAILS:
                Each audience record provides comprehensive information about:
                - Audience identification and naming
                - Type and subtype classification
                - Match count to understand audience size
                - External platform integration details
                - Account associations

                COMMON USE CASES:
                - Get all LinkedIn retargeting audiences (including Marketing Automation, Bulk, Retargeting, and Business Objective Based Audience)
                - Find Google Ads audiences suitable for retargeting campaigns
                - Identify Facebook retargeting audiences

Arguments

ArgumentTypeNotes
channel string required The advertising channel to fetch retargeting audiences for
one of: GOOGLE_ADS, LINKEDIN, FACEBOOK

Request

curl
curl -s -X POST https://mcp-server.metadata.io/mcp \
  -H "Authorization: $METADATA_PAT" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_retargeting_audiences","arguments":{"channel":"GOOGLE_ADS"}}}'

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.

arguments used
{
 "channel": "GOOGLE_ADS"
}

Real, from the production server, in 941 ms. The full response was 27,588 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.

recorded response
[
 {
  "id": "[id redacted]",
  "mdId": null,
  "name": "[name redacted]",
  "type": "[type redacted]",
  "subtype": "GOOGLE_ADS_RETARGETING",
  "channel": "[channel redacted]",
  "matchCount": 0,
  "matchCountType": null,
  "externalAccountId": "[externalAccountId redacted]",
  "externalName": null,
  "externalSubType": null,
  "seedSourcePlatform": null,
  "alreadyImported": false
 },
 {
  "id": "[id redacted]",
  "mdId": null,
  "name": "[name redacted]",
  "type": "[type redacted]",
  "subtype": "GOOGLE_ADS_RETARGETING",
  "channel": "[channel redacted]",
  "matchCount": 0,
  "matchCountType": null,
  "externalAccountId": "[externalAccountId redacted]",
  "externalName": null,
  "externalSubType": null,
  "seedSourcePlatform": null,
  "alreadyImported": false
 },
 {
  "id": "[id redacted]",
  "mdId": null,
  "name": "[name redacted]",
  "type": "[type redacted]",
  "subtype": "GOOGLE_ADS_RETARGETING",
  "channel": "[channel redacted]",
  "matchCount": 0,
  "matchCountType": null,
  "externalAccountId": "[externalAccountId redacted]",
  "externalName": null,
  "externalSubType": null,
  "seedSourcePlatform": null,
  "alreadyImported": false
 },
 {
  "id": "[id redacted]",
  "mdId": null,
  "name": "[name redacted]",
  "type": "[type redacted]",
  "subtype": "GOOGLE_ADS_RETARGETING",
  "channel": "[channel redacted]",
  "matchCount": 0,
  "matchCountType": null,
  "externalAccountId": "[externalAccountId redacted]",
  "externalName": null,
  "externalSubType": null,
  "seedSourcePlatform": null,
  "alreadyImported": false
 },
 {
  "id": "[id redacted]",
  "mdId": null,
  "name": "[name redacted]",
  "type": "[type redacted]",
  "subtype": "GOOGLE_ADS_RETARGETING",
  "channel": "[channel redacted]",
  "matchCount": 0,
  "matchCountType": null,
  "externalAccountId": "[externalAccountId redacted]",
  "externalName": null,
  "externalSubType": null,
  "seedSourcePlatform": null,
  "alreadyImported": false
 },
 {
  "id": "[id redacted]",
  "mdId": null,
  "name": "[name redacted]",
  "type": "[type redacted]",
  "subtype": "GOOGLE_ADS_RETARGETING",
  "channel": "[channel redacted]",
  "matchCount": 0,
  "matchCountType": null,
  "externalAccountId": "[externalAccountId redacted]",
  "externalName": null,
  "externalSubType": null,
  "seedSourcePlatform": null,
  "alreadyImported": false
 },
 {
  "id": "[id redacted]",
  "mdId": null,
  "name": "[name redacted]",
  "type": "[type redacted]",
  "subtype": "GOOGLE_ADS_RETARGETING",
  "channel": "[channel redacted]",
  "matchCount": 100,
  "matchCountType": null,
  "externalAccountId": "[externalAccountId redacted]",
  "externalName": null,
  "externalSubType": null,
  "seedSourcePlatform": null,
  "alreadyImported": false
 },
 {
  "id": "[id redacted]",
  "mdId": null,
  "name": "[name redacted]",
  "type": "[type redacted]",
  "subtype": "GOOGLE_ADS_RETARGETING",
  "channel": "[channel redacted]",
  "matchCount": 0,
  "matchCountType": null,
  "externalAccountId": "[externalAccountId redacted]",
  "externalName": null,
  "externalSubType": null,
  "seedSourcePlatform": null,
  "alreadyImported": false
 },
 {
  "id": "[id redacted]",
  "mdId": null,
  "name": "[name redacted]",
  "type": "[type redacted]",
  "subtype": "GOOGLE_ADS_RETARGETING",
  "channel": "[channel redacted]",
  "matchCount": 0,
  "matchCountType": null,
  "externalAccountId": "[externalAccountId redacted]",
  "externalName": null,
  "externalSubType": null,
  "seedSourcePlatform": null,
  "alreadyImported": false
 },
 {
  "id": "[id redacted]",
  "mdId": null,
  "name": "[name redacted]",
  "type": "[type redacted]",
  "subtype": "GOOGLE_ADS_RETARGETING",
  "channel": "[channel redacted]",
  "matchCount": 0,
  "matchCountType": null,
  "externalAccountId": "[externalAccountId redacted]",
  "externalName": null,
  "externalSubType": null,
  "seedSourcePlatform": null,
  "alreadyImported": false
 },
 {
  "id": "[id redacted]",
  "mdId": null,
  "name": "[name redacted]",
  "type": "[type redacted]",
  "subtype": "
  … truncated

Other audiences tools:

All 160 tools · machine-readable index