# Reddit Keyword Search via agentdata-api

> Reddit Keyword Search via agentdata-api is a paid API for AI agents from agentdata-api.sander-van-aard.workers.dev, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Keyword-search all of Reddit or a specific subreddit for matching posts, returning titles, authors, scores, timestamps and permalinks sorted by various criteria.

## Facts

- Endpoint: POST https://agentdata-api.sander-van-aard.workers.dev/relay/reddit-search
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/reddit-keyword-search-via-agentdata-api-63521cdc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Q-dCR_t3B5fKGc4Lu64W3

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 reddit-keyword-search-via-agentdata-api-63521cdc -d '<json body>'
```

Example prompt: Search all of Reddit for posts mentioning 'Claude AI' sorted by top results from the past month and show me the titles, scores, and links.

## When to prefer this

Choose this endpoint when you need live Reddit search without requiring a Reddit account, OAuth credentials, or API key — and you want pay-per-call pricing at $0.05 USDC with no subscription. Ideal for AI agents doing one-off brand monitoring, topic discovery, or social listening tasks where setting up Reddit API credentials is impractical. Prefer this over direct Reddit API access when building agent workflows that need to search Reddit programmatically on demand.

## Known failure modes

- 503 returned if upstream Reddit relay is down (no charge applied)
- Empty result set if no posts match the keyword query
- Subreddit not found or misspelled returns error
- Rate limiting or quota exhaustion may return error responses
- Malformed request body missing required fields returns validation error

## How this service works

Keyword-search all of Reddit (or one subreddit) for $0.05 per call — social listening for AI agents without login or API key. Returns matching posts with title, author, subreddit, score, comment count, permalink and timestamp, sorted by relevance, top, new, hot or comments, with an optional time window. Track brand mentions, monitor topics, surface community sentiment. Relayed live from a proven upstream source; if the source is down you get a 503 and pay nothing. Pay per call in USDC on Base.

## Output

A list of matching Reddit posts each containing: post title, author username, subreddit name, upvote score, comment count, permalink URL, and timestamp. Results are sorted by the requested criterion (relevance, top, new, hot, or comments) and optionally filtered by time window. Returns a 503 with no charge if the upstream Reddit relay is unavailable.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object"
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    }
   },
   "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/reddit-keyword-search-via-agentdata-api-63521cdc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentdata-api.sander-van-aard.workers.dev](https://www.zero.xyz/host/agentdata-api.sander-van-aard.workers.dev/llms.txt)