# StableSocial Reddit Search

> StableSocial Reddit Search is a paid API for AI agents from stablesocial.dev, paid per call via x402, $0.06/call, status unknown (last checked 2026-09-15).

Search Reddit posts by keyword with sorting and timeframe filtering, returning structured post data without authentication or subscriptions.

## Facts

- Endpoint: POST https://stablesocial.dev/api/sc/reddit/search
- Price: $0.06/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/stablesocial-reddit-search-4e119318
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AHxi74Q_O74PTzUMlYRKV

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 stablesocial-reddit-search-4e119318 -d '<json body>'
```

Example prompt: Search Reddit for posts about 'electric vehicles' sorted by top posts from the past month and give me the results — trimmed down to essentials.

## When to prefer this

Choose this endpoint when you need Reddit-specific search data without setting up Reddit API credentials or managing OAuth. It is ideal for agents that need ad-hoc, pay-per-call Reddit search without subscriptions, and when you want to combine Reddit data with other social platforms available on StableSocial in the same workflow.

## Known failure modes

- Empty results if query matches no Reddit posts in the given timeframe
- Invalid sort or timeframe enum values return a 400-level error
- Missing or empty query string causes validation failure
- Rate limiting or Reddit-side blocks may return an error
- Pagination cursor ('after') from a different query returns unexpected results

## How this service works

Pay-per-request access to social media data from TikTok, Instagram, Facebook, Reddit, and LinkedIn. No auth, no subscriptions.

## Output

A list of Reddit posts matching the search query, each containing post title, URL, subreddit, score, comment count, author, and timestamp. When trim is true, returns a condensed version with only essential fields. Includes a pagination cursor for fetching subsequent pages.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sort": {
   "enum": [
    "relevance",
    "new",
    "top",
    "comment_count"
   ],
   "type": "string",
   "description": "Sort by"
  },
  "trim": {
   "type": "boolean",
   "description": "Set to true for a trimmed down version of the response"
  },
  "after": {
   "type": "string",
   "description": "Used to paginate to next page"
  },
  "query": {
   "type": "string",
   "minLength": 1,
   "description": "Search query"
  },
  "timeframe": {
   "enum": [
    "all",
    "day",
    "week",
    "month",
    "year"
   ],
   "type": "string",
   "description": "Timeframe"
  }
 }
}
```

## More

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