# Reddit Subreddit Search

> Reddit Subreddit Search is a paid API for AI agents from x402.apidirect.io, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-30).

Search Reddit subreddits by keyword, returning up to 25 results per page across up to 10 pages.

## Facts

- Endpoint: GET https://x402.apidirect.io/v1/reddit/subreddits?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/reddit-subreddit-search-c705f795
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RTvgKinNfqztAGfEQVpch

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability reddit-subreddit-search-c705f795
```

Example prompt: Can you find me subreddits related to 'personal finance'? Fetch 3 pages of results so I get a good variety of communities to explore.

## When to prefer this

Choose this endpoint when you need to discover or enumerate Reddit communities by topic keyword, particularly for market research, community monitoring, content strategy, or identifying niche audiences. Prefer it over Reddit user search when the goal is finding communities rather than individuals, and over post-search endpoints when you want to identify the communities themselves rather than specific content within them.

## Known failure modes

- Empty results if no subreddits match the keyword
- Query exceeds 500 character limit returning a validation error
- Pages parameter outside 1-10 range returning a validation error
- Reddit rate limiting or availability issues causing request failure
- Payment failure if USDC balance is insufficient

## How this service works

Search subreddits by keyword.

## Output

A paginated list of subreddits matching the search keyword, with each page returning up to 25 subreddits including subreddit names and associated metadata. Up to 10 pages (250 subreddits total) can be retrieved per query.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "query"
     ],
     "properties": {
      "pages": {
       "type": "integer",
       "default": 1,
       "maximum": 10,
       "minimum": 1,
       "description": "Number of pages to fetch, 1-10 (default: 1). Each page returns up to 25 subreddits."
      },
      "query": {
       "type": "string",
       "maxLength": 500,
       "description": "Search keyword (max 500 characters)"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/reddit-subreddit-search-c705f795/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.apidirect.io](https://www.zero.xyz/host/x402.apidirect.io/llms.txt)