# SocialFetch Reddit Search

> SocialFetch Reddit Search is a paid API for AI agents from api.socialfetch.dev, paid per call via x402, $0.014/call, status unknown (last checked 2026-09-14).

Search public Reddit posts by keyword with optional sorting and time filtering, returning paginated results.

## Facts

- Endpoint: GET https://api.socialfetch.dev/v1/reddit/search
- Price: $0.014/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/socialfetch-reddit-search-3a727a2e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_egANjvuIz6zncTDt5-iLV

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 socialfetch-reddit-search-3a727a2e
```

Example prompt: Search Reddit for posts about 'AI agent frameworks', sorted by top results from the past month, and show me what people are saying.

## When to prefer this

Use this endpoint when you need to programmatically search Reddit posts by keyword across all of Reddit, with control over sort order (relevance, new, top) and time range. Prefer this over manual scraping or Reddit's own API when you need a simple paid-per-call REST interface without OAuth setup.

## Known failure modes

- Missing required 'query' parameter returns a validation error
- Query exceeding 512 characters is rejected
- Invalid enum value for sortBy or timeframe returns a schema error
- Expired or invalid pagination cursor returns an error
- Reddit API rate limits or downtime may cause upstream failures
- No results found for the query returns an empty list

## How this service works

Search Reddit posts site-wide by keyword (not scoped to one subreddit — use reddit.subreddit.search.list for that).

## Output

A paginated list of public Reddit posts matching the search query, including post titles, body text, subreddit, author, upvote count, comment count, and post URL. A cursor is returned for fetching the next page of results.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "query"
     ],
     "properties": {
      "trim": {
       "anyOf": [
        {
         "type": "boolean"
        },
        {
         "enum": [
          "0",
          "1",
          "true",
          "false"
         ],
         "type": "string"
        }
       ],
       "description": "Whether to request a smaller response shape when available."
      },
      "query": {
       "type": "string",
       "maxLength": 512,
       "minLength": 1,
       "description": "Search query text for public Reddit posts."
      },
      "cursor": {
       "type": "string",
       "minLength": 1,
       "description": "Opaque pagination cursor returned by a previous response."
      },
      "sortBy": {
       "enum": [
        "relevance",
        "new",
        "top"
       ],
       "type": "string",
       "description": "Optional sort order for search results."
      },
      "timeframe": {
       "enum": [
        "all",
        "day",
        "week",
        "month",
        "year"
       ],
       "type": "string",
       "description": "Optional time range filter for search results."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

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