# Search Reddit

> Search Reddit is a paid API for AI agents from ZeroClick x402 Service Registry at reddit.withzero.ai, paid per call via MPP, $0.003/call, live (last probed 2026-10-12, last successful call 2026-10-09).

Agents call it through Zero, which pays per call: no API key and no wallet of your own. New accounts start with $5.

Search Reddit posts and discussions by keyword, returning posts with engagement metrics and relevance scores — no API key required.

## Facts

- Endpoint: POST https://reddit.withzero.ai/run?utm_source=zero.xyz
- Price: $0.003/call
- Payment: MPP
- Status: healthy
- Last checked: 2026-10-12
- Last successful call: 2026-10-09
- Success rate: 45% of calls made through Zero
- Activations on Zero: 29
- Provider: ZeroClick x402 Service Registry
- Website: https://withzero.ai
- Tags: search, reddit, social, discussion, forum
- Canonical page: https://www.zero.xyz/c/zeroclick-x402-service-registry-search-reddit-523be5dd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5C1KQ9oZjgsFiRxJ4TL6V

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 zeroclick-x402-service-registry-search-reddit-523be5dd -d '<json body>'
```

Example prompt: Search Reddit for discussions about 'electric vehicle charging at home' from the last 14 days and show me the top 10 results with their upvote counts and comment counts.

## When to prefer this

Use this endpoint when you need to surface real community discussions, public opinions, or crowd-sourced knowledge from Reddit on any topic — especially when no Reddit API key is available. Prefer this over general web search when the goal is specifically Reddit content with engagement signals (upvotes, comments) and relevance scoring. Ideal for sentiment research, trend discovery, or finding niche community advice.

## Known failure modes

- Empty results if query matches no indexed Reddit posts within the specified date range
- Limit capped at 50 — requests for more results will be silently truncated
- Days parameter max is 90 — older posts not retrievable
- Reddit rate limits or downtime may cause upstream failures with no results returned
- Ambiguous or very short queries may return low-relevance posts with poor scores

## How this service works

Search Reddit posts and discussions. Input: search query with optional days/limit. Output: posts with engagement metrics and relevance scores.

## Output

Returns a JSON object with the original query, source platform, total result count, and an array of up to 50 Reddit posts — each with title, direct URL, author username, publication date, upvote score, comment count, a snippet of the post text, and a combined relevance+engagement score from 0 to 100.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "query"
 ],
 "properties": {
  "days": {
   "type": "integer",
   "default": 30,
   "maximum": 90,
   "minimum": 1,
   "description": "How many days back to search (default: 30)"
  },
  "limit": {
   "type": "integer",
   "default": 20,
   "maximum": 50,
   "minimum": 1,
   "description": "Maximum results to return (default: 20)"
  },
  "query": {
   "type": "string",
   "description": "Search topic or keywords"
  }
 },
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "query",
  "source",
  "resultCount",
  "results"
 ],
 "properties": {
  "query": {
   "type": "string",
   "description": "The query that was searched"
  },
  "source": {
   "type": "string",
   "description": "Platform name"
  },
  "results": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "title",
     "url",
     "author",
     "date",
     "score",
     "engagement",
     "snippet"
    ],
    "properties": {
     "url": {
      "type": "string",
      "description": "Direct link to the Reddit post"
     },
     "date": {
      "type": "string",
      "description": "Publication date (ISO 8601) when known; empty string otherwise"
     },
     "score": {
      "type": "number",
      "description": "Combined relevance + search-rank score (0-100)"
     },
     "title": {
      "type": "string",
      "description": "Post title"
     },
     "author": {
      "type": "string",
      "description": "Subreddit (r/<name>) the post belongs to"
     },
     "snippet": {
      "type": "string",
      "description": "Post text preview or subreddit info"
     },
     "engagement": {
      "type": "object",
      "properties": {
       "likes": {
        "type": "number",
        "description": "Upvote score"
       },
       "comments": {
        "type": "number",
        "description": "Comment count"
       }
      },
      "description": "Engagement metrics",
      "additionalProperties": false
     }
    },
    "additionalProperties": false
   }
  },
  "resultCount": {
   "type": "number",
   "description": "Number of results returned"
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/zeroclick-x402-service-registry-search-reddit-523be5dd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from reddit.withzero.ai](https://www.zero.xyz/host/reddit.withzero.ai/llms.txt)