MMetadata /docs
⌘K
Docs/Tools/get_deep_audience_details

get_deep_audience_details

Get detailed information about audiences including criteria and advanced configuration.

Read audiences

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

What it does

Get detailed information about audiences including criteria and advanced configuration.

                This tool returns comprehensive audience data beyond the basic summary, including:
                - Complete audience criteria and targeting configuration
                - Segment information and settings
                - Lookback window configuration
                - Advanced configuration details and metadata
                - Full audience structure and composition

                **WHEN TO USE:**
                - Retrieve complete audience criteria and configuration
                - Analyze detailed targeting setup for an audience
                - Export or review full audience specifications
                - Understand advanced audience configuration
                - Compare detailed configuration across multiple audiences

                PARAMETERS:
                - audience_ids: Array of audience IDs to retrieve details for (required)
                  Example: [42828, 42829, 42831]

                AUDIENCE ID SOURCES:
                Use the get_audience_details tool first to:
                - List all available audiences in your account
                - Find the IDs of audiences you want detailed information for
                - Get the basic summary before requesting deep details

                EXAMPLE WORKFLOW:
                1. Call get_audience_details() to see all audiences and their IDs
                2. Identify which audiences you need deep details for
                3. Call get_deep_audience_details(audience_ids=[42828, 42831]) to get full configuration

                RETURNS:
                Detailed audience information including:
                - Audience ID, name, and type
                - Complete targeting criteria
                - Segment configuration (if applicable)
                - Lookback window settings
                - Advanced metadata and configuration
                - Full audience composition details

                IMPORTANT NOTES:
                - All provided audience IDs must exist and be valid
                - IDs must be positive integers
                - You can request details for multiple audiences in a single call
                - Results include complete audience configuration data

Arguments

ArgumentTypeNotes
audience_ids array required Array of audience IDs to retrieve detailed information for. Example: [42828, 42829, 42831]

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.

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_deep_audience_details","arguments":{"audience_ids":[]}}}'

Response

No recorded response. This tool needs arguments that only exist inside an account, so no response is recorded here. The request is an illustrative template. Fill required fields and check the current schema before calling it. No response is fabricated.

Other audiences tools:

Browse the tool catalog · machine-readable index