# fetcher.sh Reddit Subreddit Search

> fetcher.sh Reddit Subreddit Search is a paid API for AI agents from fetcher.sh, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Search Reddit for posts and content within subreddits by keyword or query, returning structured results

## Facts

- Endpoint: GET https://fetcher.sh/api/reddit/search/subreddit
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fetcher-sh-reddit-subreddit-search-bfdc1259
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_irINGh7V4ZWlpXSl5vGd0

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 fetcher-sh-reddit-subreddit-search-bfdc1259
```

Example prompt: Search Reddit for discussions about 'mechanical keyboards' in the r/MechanicalKeyboards subreddit and show me the top posts with their titles, scores, and links.

## When to prefer this

Choose this endpoint when you need to search Reddit posts by keyword within a specific subreddit without setting up OAuth, a Reddit developer account, or managing API rate limits yourself. It is ideal for AI agents that need real-time Reddit data on demand, paid per call in USDC with no subscription. Prefer this over the Reddit official API when you want zero-setup access and per-call micro-payment billing.

## Known failure modes

- Invalid or non-existent subreddit name returns empty results or 404
- No results found for the given query returns an empty list
- Rate limiting or Reddit blocking returns an error response
- Insufficient USDC balance or payment failure returns 402
- Malformed query parameters return a 400 bad request error
- Private or quarantined subreddits may return no results

## How this service works

fetcher.sh is an x402 web-data and scraping API: 111 endpoints for Twitter/X, YouTube, TikTok, Instagram, Reddit, Google, App Store, and Yelp — paid per call in USDC on Base, Polygon, Arbitrum, Monad or Solana, or with prepaid credits. Built for AI agents: no accounts, no OAuth, no subscriptions.

## Output

Returns a list of Reddit posts matching the search query, including post titles, URLs, scores (upvotes), comment counts, subreddit names, author handles, post timestamps, and post text/body snippets where available, all in structured JSON.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "required": {
   "type": "string"
  },
  "properties": {
   "type": "string"
  }
 }
}
```

## More

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