# Agent Social Relay – Reddit Search

> Agent Social Relay – Reddit Search is a paid API for AI agents from agent-social-relay.biv-ai-lab.workers.dev, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-15).

Search Reddit posts via a pay-per-call API without requiring any social account login, designed for autonomous agents.

## Facts

- Endpoint: GET https://agent-social-relay.biv-ai-lab.workers.dev/v1/reddit/search?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-social-relay-reddit-search-10370b1c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GfSJgUIUVHOz-UVgz2qTs

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 agent-social-relay-reddit-search-10370b1c
```

Example prompt: Search Reddit for recent posts about 'open source LLMs' and give me the top results — no login needed, just pull the public data.

## When to prefer this

Choose this endpoint when you need to search Reddit public posts programmatically inside an autonomous agent workflow, especially when you cannot or do not want to manage Reddit OAuth credentials. It is ideal for no-login, pay-per-use social data retrieval at $0.03 per call, making it cost-efficient for sporadic or bursty agent workloads compared to maintaining a Reddit API app registration.

## Known failure modes

- No posts found for query — returns empty posts array with next: null
- Invalid or missing query parameter — returns 4xx error
- Reddit upstream unavailable — returns 5xx or timeout
- Payment not processed or insufficient USDC — request rejected before execution
- Rate limit exceeded — request blocked

## How this service works

Pay-per-call public social data API for autonomous agents. No social account login required.

## Output

A JSON object containing a list of Reddit posts matching the search query, a pagination cursor for the next page of results (or null if exhausted), the source label ('reddit'), and a timestamp indicating when the data was fetched.

## 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": {
      "sort": {
       "enum": [
        "relevance",
        "new",
        "top",
        "comment_count"
       ],
       "type": "string"
      },
      "query": {
       "type": "string",
       "maxLength": 200,
       "minLength": 1
      },
      "timeframe": {
       "enum": [
        "all",
        "day",
        "week",
        "month",
        "year"
       ],
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "next": null,
   "posts": []
  },
  "source": "reddit",
  "fetched_at": "2026-09-25T12:00:00.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-social-relay-reddit-search-10370b1c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-social-relay.biv-ai-lab.workers.dev](https://www.zero.xyz/host/agent-social-relay.biv-ai-lab.workers.dev/llms.txt)