# ScrapFly Reddit Top Posts API

> ScrapFly Reddit Top Posts API is a paid API for AI agents from test-scrapfly.orbonomy.xyz, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-14).

Fetches top posts from Reddit for a given query or subreddit topic

## Facts

- Endpoint: POST https://test-scrapfly.orbonomy.xyz/api/reddit/top
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 1
- Tags: x402
- Canonical page: https://www.zero.xyz/c/scrapfly-reddit-top-posts-api-9709487b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_P96RP-gL06-MXdoOyfIgQ

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 scrapfly-reddit-top-posts-api-9709487b -d '<json body>'
```

Example prompt: Can you pull the top Reddit posts about 'electric vehicles' right now so I can see what the community is talking about?

## When to prefer this

Use this endpoint when you need to programmatically retrieve top Reddit posts for a given topic, keyword, or subreddit context without managing Reddit API credentials or rate limits yourself. It is ideal for agents performing social listening, trend analysis, or community sentiment research on Reddit content via a simple pay-per-use model.

## Known failure modes

- Query parameter missing — returns error if required 'query' field is absent
- Reddit rate limiting or blocking causing scrape failure
- Invalid or empty query string returning no results
- Network timeout from ScrapFly scraper infrastructure
- Payment failure via x402 on Base chain resulting in 402 response

## How this service works

69 endpoints for data, content generation, and web scraping. Pay per request via x402 on Base chain.

## Output

A JSON object with a success boolean and a data object containing top Reddit posts matching the query, including post titles, scores, and metadata scraped from Reddit.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "query"
 ],
 "properties": {
  "query": {
   "type": "string",
   "description": "Input query"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "success"
 ],
 "properties": {
  "data": {
   "type": "object"
  },
  "success": {
   "type": "boolean"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/scrapfly-reddit-top-posts-api-9709487b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from test-scrapfly.orbonomy.xyz](https://www.zero.xyz/host/test-scrapfly.orbonomy.xyz/llms.txt)