---
title: "search_reddit_criteria. Metadata MCP tool reference"
url: https://metadata.io/developers/tools/search_reddit_criteria
description: "Get available Reddit targeting criteria and their reference values (externalId + name) for target group creation. Read tool on the Metadata MCP server, with its full JSON Schema and a real recorded response."
source: metadata.io
---

# search_reddit_criteria

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

Read [audiences](https://metadata.io/developers/tools/#cat-audiences)

## What it does

## Arguments

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

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

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.

## Related

Other audiences tools:

- [archive_audience](https://metadata.io/developers/tools/archive_audience) Destructive
- [create_audience_from_segment](https://metadata.io/developers/tools/create_audience_from_segment) Writes
- [create_bombora_audience](https://metadata.io/developers/tools/create_bombora_audience) Writes
- [create_csv_upload_linkedin_native_audience](https://metadata.io/developers/tools/create_csv_upload_linkedin_native_audience) Writes
- [create_facebook_native_criteria_audience](https://metadata.io/developers/tools/create_facebook_native_criteria_audience) Writes
- [create_firmographic_audience](https://metadata.io/developers/tools/create_firmographic_audience) Writes
- [create_g2_intent_dynamic_audience](https://metadata.io/developers/tools/create_g2_intent_dynamic_audience) Writes
- [create_g2_intent_linkedin_native_dynamic_audience](https://metadata.io/developers/tools/create_g2_intent_linkedin_native_dynamic_audience) Writes

[Browse the tool catalog](https://metadata.io/developers/tools/) · [machine-readable index](https://metadata.io/developers/tools.json)