# SocialFetch Reddit Subreddit Posts

> SocialFetch Reddit Subreddit Posts 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-15).

Lists posts from a specific Reddit subreddit with optional sorting, timeframe, and pagination.

## Facts

- Endpoint: GET https://api.socialfetch.dev/v1/reddit/subreddits/:subreddit/posts
- Price: $0.014/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/socialfetch-reddit-subreddit-posts-6e65c12e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_R0u52DyrYvNYChlMXvlKn

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-subreddit-posts-6e65c12e
```

Example prompt: Can you pull the top posts from r/MachineLearning from the past week, sorted by top?

## When to prefer this

Use this endpoint when you need to retrieve a list of posts from a specific Reddit subreddit, optionally filtered by sort order (hot, new, top, rising, best) and timeframe. Prefer this over generic web scraping when you need structured Reddit post data with pagination support.

## Known failure modes

- Invalid or misspelled subreddit name returns empty results or error
- Subreddit is private or banned — access denied
- Invalid sort/timeframe combination may yield unexpected results
- Expired or malformed pagination cursor causes pagination failure
- Rate limits or payment issues return 402 or 429 errors

## How this service works

List posts from a specific subreddit.

## Output

A list of Reddit posts from the specified subreddit including post metadata (titles, scores, authors, URLs, etc.) along with a pagination cursor for fetching subsequent pages.

## 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"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "subreddit"
     ],
     "properties": {
      "subreddit": {
       "type": "string",
       "maxLength": 256,
       "minLength": 1,
       "description": "Subreddit name, optional `r/` prefix, or Reddit subreddit URL. Must match Reddit's exact casing. Lists posts for this subreddit."
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "sort": {
       "enum": [
        "best",
        "hot",
        "new",
        "top",
        "rising"
       ],
       "type": "string",
       "description": "Optional sort order for the returned posts."
      },
      "cursor": {
       "type": "string",
       "minLength": 1,
       "description": "Opaque pagination cursor from a previous response."
      },
      "timeframe": {
       "enum": [
        "all",
        "day",
        "week",
        "month",
        "year"
       ],
       "type": "string",
       "description": "Optional timeframe used only when `sort` is `top`. Ignored/rejected for other sorts."
      }
     }
    }
   },
   "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-subreddit-posts-6e65c12e/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)