# StableSocial Reddit Subreddit Search

> StableSocial Reddit Subreddit 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-14).

Search posts within a specific Reddit subreddit by keyword, with configurable sort order and timeframe filtering.

## Facts

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

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-subreddit-search-4b414e1c -d '<json body>'
```

Example prompt: Search the r/MachineLearning subreddit for posts about 'fine-tuning LLMs', sorted by top posts from the past month.

## When to prefer this

Use this endpoint when you need to search for specific content within a known subreddit rather than Reddit-wide, when you want to filter by sort order or timeframe, or when you need paginated access to subreddit search results without Reddit API credentials. Prefer this over Reddit's native API when no auth setup is desired and pay-per-request billing is acceptable.

## Known failure modes

- Subreddit does not exist or is private — returns empty or error response
- Query returns no results for highly specific or obscure search terms
- Invalid sort/timeframe enum values cause request rejection
- Cursor pagination errors if the cursor is stale or malformed
- Rate limiting or payment failure may prevent successful completion

## How this service works

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

## Output

Returns a list of Reddit posts from the specified subreddit that match the search query, including post titles, content, metadata (votes, comments, timestamps), and a pagination cursor for fetching additional results.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sort": {
   "enum": [
    "relevance",
    "hot",
    "top",
    "new",
    "comments"
   ],
   "type": "string",
   "description": "Sort order. For posts/media: relevance, hot, top, new, comments. For comments: relevance, top, new"
  },
  "query": {
   "type": "string",
   "description": "Search query to find matching content"
  },
  "cursor": {
   "type": "string",
   "description": "Cursor to get more results. Get 'cursor' from previous response."
  },
  "subreddit": {
   "type": "string",
   "minLength": 1,
   "description": "Subreddit name (e.g. 'Fitness', not 'r/Fitness' or a full URL)"
  },
  "timeframe": {
   "enum": [
    "all",
    "year",
    "month",
    "week",
    "day",
    "hour"
   ],
   "type": "string",
   "description": "Timeframe to filter results"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stablesocial-reddit-subreddit-search-4b414e1c/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)
