MMetadata /docs
⌘K
Docs/Tools/search_reddit_criteria

search_reddit_criteria

Get available Reddit targeting criteria and their reference values (externalId + name) for target group creation.

Read audiences

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

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_group

Arguments

ArgumentTypeNotes
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

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_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.

arguments used
{
 "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.

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

Other audiences tools:

All 160 tools · machine-readable index