search_reddit_criteria
Get available Reddit targeting criteria and their reference values (externalId + name) for target group creation.
Read audiences
What it does
Get available Reddit targeting criteria and their reference values (externalId + name) for target group creation.
USE FOR: "what Reddit communities match X?", "search Reddit interests/keywords", "find subreddits about Y", get valid references before create_reddit_target_group, resolve location countries/states for Reddit.
CRITERIA TYPES:
- communities: Search subreddits/communities by name (requires search_terms)
- interests: Search Reddit interest categories (requires search_terms)
- keywords: Search contextual keywords (requires search_terms)
- locations: Country/state options for the mandatory LOCATION criterion (search_terms optional; omit to list all)
RESPONSE: For communities/interests/keywords, a paginated {content: [{externalId, name}]} — use externalId in the COMMUNITIES/INTERESTS/KEYWORDS criteria. For locations, {countries, states, regions} where each item has a numeric `id` — put that numeric `id` (NOT the object) into the LOCATION criterion's countries/states arrays.
WORKFLOW: search_reddit_criteria → build targeting (LOCATION first) → create_reddit_target_groupArguments
| Argument | Type | Notes | |
|---|---|---|---|
criteria_type |
string | required | Type of Reddit criteria to search. communities/interests/keywords require search_terms; locations returns countries/states (search_terms optional). one of: communities, interests, keywords, locations |
search_terms |
array | Search keywords (min 2 characters). Required for communities/interests/keywords. Example: ['technology'] |
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 -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_reddit_criteria","arguments":{"criteria_type":"communities"}}}'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.
{
"criteria_type": "communities"
}Real, from the production server, in 163 ms. Values that identify a customer or disclose money are replaced with typed placeholders; keys, types and nesting are exactly as returned.
{
"error": "[error redacted]",
"tool": "search_reddit_criteria",
"service": "[service redacted]"
}Related
Other audiences tools: