# Reddit Search via Agent Wonderland

> Reddit Search via Agent Wonderland is a paid API for AI agents from api.agentwonderland.com, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-15).

Search Reddit posts, discover subreddits, or browse a subreddit's hot/new/top posts using the official Reddit API

## Facts

- Endpoint: POST https://api.agentwonderland.com/x402/endpoints/reddit-search
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/reddit-search-via-agent-wonderland-49f6af9c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uhnONNMFw1XAaeglVcyHa

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-search-via-agent-wonderland-49f6af9c -d '<json body>'
```

Example prompt: Search Reddit for the top 10 posts about AI agents from the past month, sorted by relevance, across all subreddits.

## When to prefer this

Choose this endpoint when you need to search or browse Reddit specifically — for finding community discussions, trending topics, user sentiment, or niche subreddit content. Prefer this over general web search when the task explicitly involves Reddit posts or communities, especially for opinion mining, community discovery, or tracking what Reddit users are saying about a topic. The official Reddit API backing ensures reliability and full support for Reddit-native search operators.

## Known failure modes

- Invalid subreddit name returns empty results or 404-style error
- Overly broad queries may return low-relevance posts
- Rate limiting or Reddit API downtime may cause failures
- Private or banned subreddits will return no results
- Max results capped at 10 — no pagination support
- Empty query with search mode may return unexpected results

## How this service works

Reddit Search: Search Reddit posts, discover subreddits, or browse a subreddit's hot/new/top posts. Official Reddit API — reliable and fast. Supports all search operators and subreddit browsing.

## Output

Returns up to 10 Reddit posts or subreddit listings matching the query. For post searches, includes post titles, URLs, scores, comment counts, subreddit names, and timestamps. For subreddit discovery mode, returns community names, descriptions, and subscriber counts. For hot/new/top browse modes, returns ranked posts from the specified subreddit.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "mode": {
   "type": "string",
   "title": "Mode",
   "default": "search",
   "description": "Mode: search (posts), subreddits (discover communities), hot/new/top (browse subreddit)"
  },
  "sort": {
   "type": "string",
   "title": "Sort",
   "default": "relevance",
   "description": "Sort: relevance, hot, new, top, comments"
  },
  "query": {
   "type": "string",
   "title": "Query",
   "default": "",
   "description": "Search query for posts",
   "json_schema_extra": {
    "example": "AI agents"
   }
  },
  "subreddit": {
   "type": "string",
   "title": "Subreddit",
   "default": "",
   "description": "Specific subreddit to search/browse",
   "json_schema_extra": {
    "example": "artificial"
   }
  },
  "max_results": {
   "type": "integer",
   "title": "Max Results",
   "default": 10,
   "maximum": 10,
   "minimum": 1,
   "description": "Max results (max 10)"
  },
  "time_filter": {
   "type": "string",
   "title": "Time Filter",
   "default": "week",
   "description": "Time range: hour, day, week, month, year, all"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/reddit-search-via-agent-wonderland-49f6af9c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.agentwonderland.com](https://www.zero.xyz/host/api.agentwonderland.com/llms.txt)