MMetadata /docs
⌘K
Docs/Tools/search_target_group_criteria

search_target_group_criteria

Get available criteria and their supported values (names and IDs) for target group creation/updates.

Read audiences

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

What it does

Get available criteria and their supported values (names and IDs) for target group creation/updates.

USE FOR: "what targeting criteria are available?", "what options for [criteria type]?", "supported values for industries/seniority/job functions", "how to search job titles/interests/member groups?", validate criteria before creating target group, get valid IDs for create_target_group.

CRITERIA TYPES:

1. LIST-BASED (returns predefined options):
   - age-ranges: Age range options
   - company-categories: Company classifications
   - company-growth-rates: Growth rate ranges
   - revenues: Revenue ranges
   - employees: Employee count ranges
   - industry-taxonomy: Industry codes/names
   - jobFunctions: Job function categories
   - seniority: Seniority levels
   - followed-companies: Company follow options
   - locations: Geographic data (MANDATORY as FIRST criteria for LinkedIn) - use search_terms for filtering

2. SEARCH-BASED (use search_terms):
   - job-title: Search job titles (reference_type: LINKEDIN_JOB_TITLES)
   - member-groups: Search LinkedIn groups (reference_type: LINKEDIN_MEMBER_GROUPS)
   - member-skills: Search professional skills
   - interests: Search interests (reference_type: LINKEDIN_INTERESTS)
   - traits: Search behaviors (reference_type: LINKEDIN_TRAITS)

3. NUMERIC: years-of-experience (0-12, not retrieved via this tool)

OPERATION MODES:
- List: search_target_group_criteria(channel="LINKEDIN", criteria_type="seniority")
- Search: search_target_group_criteria(channel="LINKEDIN", criteria_type="job-title", search_terms=["engineer"], exact_match=false)
- Direct: search_target_group_criteria(channel="LINKEDIN", reference_type="LINKEDIN_JOB_TITLES", search_terms=["engineer"])

RESPONSE: Array of {externalId, name}. Use externalId in target group config, show name to users.

CHANNEL: Only LINKEDIN supported.

Arguments

ArgumentTypeNotes
channel string required The advertising channel for which to retrieve criteria. Only LINKEDIN is supported.
one of: LINKEDIN
criteria_type string Type of targeting criteria to retrieve or search. List-based (returns predefined options): - age-ranges: Age range segments - company-categories: Company type classifications - company-growth-rates: Company growth classifications - revenues: Company revenue ranges - employees: Employee count ranges
one of: age-ranges, company-categories, company-growth-rates, revenues, employees, industry-taxonomy, jobFunctions, seniority, followed-companies, locations, job-title, member-groups
search_terms array Array of search keywords for search-based criteria (job-title, member-groups, interests, traits). Example: ['engineer', 'developer']
reference_type string Specific reference type for search operations (LinkedIn only). Auto-determined from criteria_type and channel if not provided.
one of: LINKEDIN_JOB_TITLES, LINKEDIN_MEMBER_GROUPS, BUYER_INTENT_INDUSTRIES
exact_match boolean Whether to require exact matches in search (default: true). Set to false for broader/fuzzy matching.

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":"search_target_group_criteria","arguments":{"channel":"LINKEDIN"}}}'

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": "LINKEDIN"
}

Real, from the production server, in 151 ms. Values that identify a customer or disclose money are replaced with typed placeholders; keys, types and nesting are exactly as returned.

recorded response
{
 "error": "[error redacted]",
 "tool": "[tool redacted]",
 "service": "[service redacted]"
}

Other audiences tools:

Browse the tool catalog · machine-readable index