# agdata Reddit Search & Subreddit Reader

> agdata Reddit Search & Subreddit Reader is a paid API for AI agents from agdata.shveik.dev, paid per call via x402, $0.068/call, status unknown (last checked 2026-10-02).

Search Reddit by keyword, fetch posts from a subreddit, or retrieve a user's posts, returning normalized post records with metadata.

## Facts

- Endpoint: POST https://agdata.shveik.dev/x402/reddit?utm_source=zero.xyz
- Price: $0.068/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agdata-reddit-search-subreddit-reader-c5d660ff
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_siw0ZiamlRzGQUK0OdR4i

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 agdata-reddit-search-subreddit-reader-c5d660ff -d '<json body>'
```

Example prompt: Search Reddit for the top 10 posts about 'mechanical keyboards' and show me the titles, authors, upvotes, and links.

## When to prefer this

Use this endpoint when you need structured Reddit post data — subreddit browsing, user post history, or keyword search — without needing comments. Ideal for agents that need normalized, consistent JSON output with metadata like upvotes and timestamps. Prefer over raw scraping when you need reliable field normalization across post types.

## Known failure modes

- Invalid mode value — must be one of profile, hashtag, or search
- Query string missing — required for all modes
- Limit out of range — clamped to 1-20, defaults to 5
- Private or banned subreddit returns no results or error
- Suspended or nonexistent username returns empty result set
- Reddit API rate limiting may cause partial or empty responses
- upvotes and comments_count may be null for certain post types

## How this service works

Search Reddit or read a subreddit. Use mode hashtag with a subreddit name (no r/), profile with a username, or search with keywords, plus limit 1-20. Every record carries a normalized object with kind, title, body, author, subreddit, url, created_at, upvotes and comments_count. Comments are not fetched. upvotes and comments_count can be null, and subreddit mode may return the subreddit's own record (kind: community) with its description.

## Output

An array of up to 20 normalized post records, each containing: kind (post or community), title, body text, author username, subreddit name, URL, created_at timestamp, upvotes (nullable), and comments_count (nullable). In hashtag/subreddit mode, may also return a community record with the subreddit's description.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "mode": {
   "enum": [
    "profile",
    "hashtag",
    "search"
   ],
   "type": "string",
   "description": "profile=user's posts, hashtag=subreddit's posts, search=keyword→posts"
  },
  "limit": {
   "type": "integer",
   "default": 5,
   "maximum": 20,
   "minimum": 1,
   "description": "max results returned (clamped to this range)"
  },
  "query": {
   "type": "string",
   "description": "username (profile), subreddit without r/ (hashtag), or search keywords"
  }
 }
}
```

## More

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