# Reddit Search Scraper (reddit.apitoll.cloud)

> Reddit Search Scraper (reddit.apitoll.cloud) is a paid API for AI agents from reddit.apitoll.cloud, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-15, last successful call 2026-08-22).

Searches all of Reddit or a specific subreddit by keyword, returning ranked posts with metadata including score, comments, author, subreddit, and links.

## Facts

- Endpoint: GET https://reddit.apitoll.cloud/v1/reddit/search
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Last successful call: 2026-08-22
- Success rate: 33% of calls made through Zero
- Rating: 2.3 / 5 from 1 review
- Activations on Zero: 21
- Tags: x402
- Canonical page: https://www.zero.xyz/c/reddit-search-scraper-reddit-apitoll-cloud-75a809c7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jWeinWkOb4vLWDK4yOq_P

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-search-scraper-reddit-apitoll-cloud-75a809c7
```

Example prompt: Search Reddit sitewide for posts mentioning 'Notion AI' sorted by top results from the past month, up to 25 posts, so I can see what the community is saying about it.

## When to prefer this

Use this endpoint when you need keyword-based search across Reddit without needing a Reddit account or API key, especially for brand monitoring, topic tracking, or surfacing community discussion. Prefer this over the subreddit feed endpoint when you need relevance ranking by keyword rather than chronological feed posts, and over the user profile endpoint when you want topic-based discovery rather than per-user history.

## Known failure modes

- Missing required 'q' parameter returns an error or demo results
- Subreddit name not found or private returns empty results or error
- Rate limits or Reddit blocking the scraper returns empty or partial results
- Extremely broad queries may return truncated or low-quality results
- Time window parameter only meaningfully affects 'top' sort; ignored for others

## How this service works

Reddit search scraper — keyword-search all of Reddit, or scope to one subreddit, for AI agents. Find posts matching any query, sorted by relevance, top, new, hot, or comments, with an optional time window. Returns each post’s title, author, subreddit, score, comment count, permalink, external link + domain, flair, and timestamp. No login, no API key. Track brand mentions, monitor topics, and surface Reddit discussion for agents.

## Output

A JSON object containing the search query metadata, sort and time parameters, total post count, and an array of up to 100 posts — each with id, fullId, title, author, subreddit, score, numComments, permalink URL, external link URL and domain, flair, NSFW flag, isSelf flag, createdAt and scrapedAt timestamps, and recordType.

## 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": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "Keyword or phrase to search. Wrap a multi-word phrase in double quotes for exact-match. Defaults to a demo query if omitted."
      },
      "sort": {
       "enum": [
        "relevance",
        "top",
        "new",
        "hot",
        "comments"
       ],
       "type": "string",
       "description": "Result ranking. Use relevance or top for precision."
      },
      "time": {
       "enum": [
        "hour",
        "day",
        "week",
        "month",
        "year",
        "all"
       ],
       "type": "string",
       "description": "Time window — applies to top."
      },
      "limit": {
       "type": "integer",
       "maximum": 100,
       "minimum": 1,
       "description": "Max posts to return (1-100)."
      },
      "subreddit": {
       "type": "string",
       "description": "Optional — scope the search to this subreddit (r/ prefix optional). Omit for a sitewide search."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "asOf": {
       "type": "string"
      },
      "sort": {
       "type": "string"
      },
      "count": {
       "type": "number"
      },
      "posts": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "id": {
          "type": "string"
         },
         "url": {
          "type": "string"
         },
         "score": {
          "type": "number"
         },
         "title": {
          "type": "string"
         },
         "author": {
          "type": "string"
         },
         "fullId": {
          "type": "string"
         },
         "isNsfw": {
          "type": "boolean"
         },
         "isSelf": {
          "type": "boolean"
         },
         "createdAt": {
          "type": "string"
         },
 
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "asOf": "2026-07-15T12:00:00Z",
  "sort": "relevance",
  "count": 25,
  "posts": [
   {
    "id": "def456",
    "url": "https://www.reddit.com/r/rust/comments/def456/why_rusts_ownership/",
    "score": 934,
    "title": "Why Rust’s ownership model clicks after a month",
    "author": "rustacean",
    "fullId": "t3_def456",
    "isNsfw": false,
    "isSelf": true,
    "createdAt": "2026-07-14T18:02:00Z",
    "scrapedAt": "2026-07-15T12:00:00Z",
    "subreddit": "rust",
    "recordType": "post",
    "numComments": 118
   }
  ],
  "query": {
   "q": "rust language",
   "scoped": false
  },
  "source": {
   "via": "Apify",
   "name": "Reddit"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/reddit-search-scraper-reddit-apitoll-cloud-75a809c7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from reddit.apitoll.cloud](https://www.zero.xyz/host/reddit.apitoll.cloud/llms.txt)