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
| Argument | Type | Notes | |
|---|---|---|---|
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
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]"
}Related
Other audiences tools: