# Reddit Search

> Reddit Search is a paid API for AI agents from StableEnrich at stableenrich.dev, paid per call via MPP or x402, $0.02/call, live (last probed 2026-10-12, last successful call 2026-10-07).

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 by keyword with sorting, timeframe filtering, and pagination support

## Facts

- Endpoint: POST https://stableenrich.dev/api/reddit/search?utm_source=zero.xyz
- Price: $0.02/call
- Payment: MPP, x402
- Status: healthy
- Last checked: 2026-10-12
- Last successful call: 2026-10-07
- Success rate: 94% of calls made through Zero
- Rating: 4.0 / 5 from 9 reviews
- Activations on Zero: 313
- Provider: StableEnrich
- Docs: https://stableenrich.dev
- Website: https://stableenrich.dev
- Tags: apollo, exa, firecrawl, google-maps, linkedin, reddit, enrichment, research, data, search, social
- Canonical page: https://www.zero.xyz/c/stableenrich-search-053bf159
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_g2QOp7ETWUecRl0SgVi5O

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 stableenrich-search-053bf159 -d '<json body>'
```

Example prompt: Search Reddit for posts about 'electric vehicles' from the past month, sort by top score, and return up to 15 results.

## When to prefer this

Use this endpoint when you need to search Reddit specifically for community discussions, opinions, or user-generated content on a topic. Prefer this over general web search endpoints when the goal is to find Reddit posts with social signals (scores, comment counts), filter by recency or relevance, or paginate through large result sets. It is better than scraping Reddit directly and provides structured, clean post data.

## Known failure modes

- Missing required 'query' field returns a validation error
- Query string shorter than 1 character is rejected
- maxResults exceeding 25 is rejected due to schema maximum
- Invalid enum value for sort or timeframe returns a validation error
- Empty result set returned if no posts match the query and filters
- Pagination cursor 'after' pointing to an expired or invalid position may return empty results
- Reddit API rate limits or downtime may cause upstream failures

## How this service works

Reddit Search - Search Reddit posts

## Output

Returns an array of Reddit posts each containing post ID, title, author username, subreddit name, score (upvotes), number of comments, creation timestamp, post body text (may be truncated), and a permalink. Also includes a pagination cursor for fetching the next page and a search context object with the original query and total result count.

## Example request

```json
{
 "sort": "relevance",
 "query": "artificial intelligence",
 "timeframe": "month",
 "maxResults": 10
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "query"
 ],
 "properties": {
  "sort": {
   "enum": [
    "relevance",
    "new",
    "top",
    "comment_count"
   ],
   "type": "string",
   "default": "relevance",
   "description": "Sort order for results"
  },
  "after": {
   "type": "string",
   "description": "Pagination cursor"
  },
  "query": {
   "type": "string",
   "minLength": 1,
   "description": "Search term for Reddit posts"
  },
  "timeframe": {
   "enum": [
    "all",
    "day",
    "week",
    "month",
    "year"
   ],
   "type": "string",
   "default": "all",
   "description": "Time range filter"
  },
  "maxResults": {
   "type": "number",
   "default": 10,
   "maximum": 25,
   "minimum": 1,
   "description": "Maximum results to return"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "posts",
  "after",
  "searchContext"
 ],
 "properties": {
  "after": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ]
  },
  "posts": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "id",
     "title",
     "author",
     "subreddit",
     "score",
     "numComments",
     "createdAt",
     "selftext",
     "selftextTruncated",
     "permalink"
    ],
    "properties": {
     "id": {
      "type": "string"
     },
     "score": {
      "type": "number"
     },
     "title": {
      "type": "string"
     },
     "author": {
      "type": "string"
     },
     "selftext": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ]
     },
     "createdAt": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ]
     },
     "permalink": {
      "type": "string"
     },
     "subreddit": {
      "type": "string"
     },
     "numComments": {
      "type": "number"
     },
     "selftextTruncated": {
      "type": "boolean"
     }
    },
    "additionalProperties": false
   }
  },
  "searchContext": {
   "type": "object",
   "required": [
    "query",
    "resultCount"
   ],
   "properties": {
    "query": {
     "type": "string"
    },
    "resultCount": {
     "type": "number"
    }
   },
   "additionalProperties": false
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stableenrich-search-053bf159/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stableenrich.dev](https://www.zero.xyz/host/stableenrich.dev/llms.txt)