# RedditDataAPI.io

> Real-Time Reddit Posts, Comments Tree, Subreddit Feeds & Brand Mention Monitoring JSON API (No Official Reddit OAuth Rate Limits). Unified Credit System ($1 = 10,000 Credits): $0.10 per 1,000 posts, $0.10 per 1,000 comments, $0.20 per 1,000 entity lookups.
> Full Machine-Readable Reference for LLMs: https://redditdataapi.io/llms-full.txt
> OpenAPI 3.0 Spec: https://redditdataapi.io/openapi.json (and https://api.redditdataapi.io/openapi.json)

## Pricing & Credit System

- Unified Credit Rate: $1 = 10,000 Credits (1 Credit = $0.0001), minimum 2 Credits ($0.0002) per non-empty call (0 Credits on empty search or failed calls)
- Subreddit posts, global keyword search, popular feed, user posts: 1 Credit / post ($0.10 per 1,000 posts, up to 100 posts per call)
- Post nested comment tree & user comments: 1 Credit / comment ($0.10 per 1,000 comments, up to 200 comments per call)
- Single subreddit info, post detail, user profile lookup: 2 Credits / request ($0.20 per 1,000 lookups)
- Free Trial: 2,000 Credits free on sign-up (no credit card required, 30 RPM)
- Starter: $19/mo or $25 PAYG -> 250,000 Credits (+25% bonus, 120 RPM)
- Pro: $69/mo or $89 PAYG -> 1,200,000 Credits (+40% bonus, 300 RPM)
- Business: $199/mo or $249 PAYG -> 5,000,000 Credits (+65% bonus, 600 RPM)
- Refunds: payments from the last 14 days, up to the unused balance

## AI Agent & No-Code Integration

- Complete Single-File LLM Reference: [llms-full.txt](https://redditdataapi.io/llms-full.txt)
- OpenAPI 3.0 JSON Specification: [openapi.json](https://redditdataapi.io/openapi.json)
- Free Online Reddit JSON Inspector & Debugger: [Reddit Developer Tools](https://redditdataapi.io/tools)
- MCP Server for Claude Desktop, Cursor & Windsurf: `npx -y @redditdataapi/mcp-server` ([MCP Guide](https://redditdataapi.io/mcp))
- No-Code Scraper on Apify: [Run on Apify](https://apify.com/kaitoeasyapi/reddit-scraper)

## Engineering Guides (/guides)

- [All Engineering Guides](https://redditdataapi.io/guides)
- [Unofficial Reddit API vs Official Reddit Data API: Complete 2026 Developer Guide](https://redditdataapi.io/guides/unofficial-reddit-api): Compare the Official Reddit Data API and PRAW against RedditDataAPI.io. Fetch subreddit feeds, nested comment trees, and brand mentions without OAuth limits.
- [How to Build Real-Time Reddit Brand Mention & Keyword Alerts in Python](https://redditdataapi.io/guides/reddit-brand-mention-monitoring-api): Poll global Reddit keyword mentions with /v1/posts/search and incremental ?since= timestamps. Zero credits charged on empty polls.
- [Scraping Nested Reddit Comment Trees for LLM & RAG Pipelines](https://redditdataapi.io/guides/reddit-comment-tree-scraper-api): Extract up to 200 nested Reddit comments per request with depth, parent_id, score, and author metadata at $0.10 per 1,000 comments.

## Competitor Comparisons (/compare)

- [All Provider Comparisons](https://redditdataapi.io/compare)
- [RedditDataAPI.io vs Official Reddit Data API](https://redditdataapi.io/compare/official-api): Compare RedditDataAPI.io against the Official Reddit Data API: $0.10/1K posts & comments, zero OAuth app review, 600 RPM burst, and LLM/RAG commercial readiness.
- [RedditDataAPI.io vs PRAW (Python Reddit API Wrapper)](https://redditdataapi.io/compare/praw): Why production Python teams replace PRAW with RedditDataAPI.io: no OAuth credentials, no 403 datacenter IP blocks, and instant 200-comment tree extraction.
- [RedditDataAPI.io vs Apify Reddit Scrapers](https://redditdataapi.io/compare/apify-scrapers): Compare RedditDataAPI.io ($0.10/1K posts, <250ms synchronous REST) against Apify Reddit Actor runs ($1.50+/1K items, 30–60s cold starts).

## Core Pages

- [Documentation](https://redditdataapi.io/docs): quickstart, authentication, credit billing, rate limits, pagination
- [Pricing](https://redditdataapi.io/pricing): 4-tier plans, per-endpoint rate card, interactive calculator
- [MCP Server](https://redditdataapi.io/mcp): Model Context Protocol setup for Claude & Cursor
- [Terms of Service](https://redditdataapi.io/terms)
- [Privacy Policy](https://redditdataapi.io/privacy)
- [Refund Policy](https://redditdataapi.io/refunds)

## Endpoints

### System

- [Gateway Health & Mirror Telemetry](https://redditdataapi.io/docs/health): `GET /v1/health` (0 Credits (Free))

### Other

- [Fetch Subreddit Posts Feed (hot / new / top / rising)](https://redditdataapi.io/docs/subreddit-posts): `GET /v1/subreddit/posts` (2 Credits)
- [Fetch Subreddit Metadata, Subscribers & Community Rules](https://redditdataapi.io/docs/subreddit-info): `GET /v1/subreddit/info` (2 Credits)
- [Search Reddit Posts & Brand Mentions Globally or Within a Subreddit](https://redditdataapi.io/docs/posts-search): `GET /v1/posts/search` (2 Credits)
- [Fetch Single Reddit Post Detail by ID or URL](https://redditdataapi.io/docs/posts-detail): `GET /v1/posts/detail` (2 Credits)
- [Fetch Post Comment Tree & Replies](https://redditdataapi.io/docs/posts-comments): `GET /v1/posts/comments` (2 Credits)
- [Fetch Trending & Popular Reddit Posts (r/popular)](https://redditdataapi.io/docs/posts-popular): `GET /v1/posts/popular` (2 Credits)
- [Fetch Reddit User Profile & Karma Breakdown](https://redditdataapi.io/docs/users-profile): `GET /v1/users/profile` (2 Credits)
- [Fetch Public Posts Submitted by a Reddit User](https://redditdataapi.io/docs/users-posts): `GET /v1/users/posts` (2 Credits)
- [Fetch Public Comments Authored by a Reddit User](https://redditdataapi.io/docs/users-comments): `GET /v1/users/comments` (2 Credits)

## FAQ

### How does the Unified Credit System work?

$1 equals 10,000 Credits (1 Credit = $0.0001). Every endpoint deducts credits based on the records returned, with a minimum floor of 2 Credits ($0.0002) per non-empty call: 1 Credit per post ($0.10 / 1,000 posts), 1 Credit per comment ($0.10 / 1,000 comments), and 2 Credits ($0.20 / 1,000 calls) for single subreddit metadata, post detail, or user profile lookups.

### Do I need a Reddit OAuth client ID, app approval, or residential proxies?

No. Unlike the Official Reddit Data API—which requires commercial OAuth review, strict 100 QPM per-token caps, and $0.24 per 1,000 API calls—RedditDataAPI.io handles all upstream proxy rotation, session management, and multi-provider failover at the gateway layer. You simply make standard HTTPS GET requests with your x-api-key: rd_live_... header.

### How does /v1/posts/comments return nested Reddit comment trees?

GET /v1/posts/comments returns up to 200 comments per call with explicit depth (0 for top-level comments, 1+ for nested replies), parent_id (t3_... for root comments or t1_... for replies), author, score, is_submitter, and created_utc. You can reconstruct the full hierarchical thread in 5 lines of Python or feed the flattened array directly into an LLM / RAG vector index.

### Am I charged when a request fails, returns 404, or returns 0 results?

Never. We strictly enforce Charge-Before-Return & Zero-Charge on Error/Empty: only HTTP 200 responses with non-empty data deduct credits. Upstream errors, non-existent subreddits/posts (HTTP 404), rate-limited requests (HTTP 429), and empty search results cost 0 Credits.

### Should I choose a Monthly Plan or Pay-As-You-Go (One-Time Top-Up)?

Both credit your account with the exact same bonus credit packages (Starter 250,000 Credits, Pro 1,200,000 Credits, Business 5,000,000 Credits). Pay-As-You-Go top-ups have no recurring billing and your purchased credit balance never expires. Monthly subscriptions save up to 24% more for continuous subreddit and brand monitoring workloads.

### What are the concurrency, pagination, and RPM rate limits?

Free Trial accounts include 2,000 Credits, 60 RPM, and the first 2 pages per query for evaluation. Paid accounts unlock unlimited deep cursor pagination and scale from 120 RPM (Starter) and 600 RPM (Pro) up to 600 RPM (Business).

### What payment methods are accepted?

You can top up or subscribe instantly with 0%-fee Cryptocurrency via NOWPayments (USDT or USDC on Solana, Tron, Polygon, Arbitrum, BNB Smart Chain, and Ethereum, plus BTC, ETH, and SOL) with an automatic +5% bonus credit reward.

### Can I use RedditDataAPI.io inside Claude Desktop, Cursor, or LangChain?

Yes. Configure our MCP Server in Claude Desktop, Cursor, or Windsurf using your rd_live_... API key to give AI agents real-time subreddit feed inspection, keyword brand mention search, and comment tree sentiment analysis tools.

### How does RedditDataAPI.io compare to PRAW and the Official Reddit API?

PRAW requires an approved Reddit OAuth application, enforces strict rate limits per OAuth token, and blocks commercial AI/LLM scraping under Reddit's Data API terms. RedditDataAPI.io provides a drop-in REST JSON gateway with up to 600 RPM, L1 Redis caching, and a local PostgreSQL 16 mirror at $0.10 per 1,000 posts or comments.

### Is RedditDataAPI.io affiliated with Reddit, Inc.?

No. RedditDataAPI.io is an independent developer infrastructure provider for publicly available web data and is not affiliated with, endorsed by, or sponsored by Reddit, Inc.

### How much does it cost to fetch 100,000 Reddit posts or comments?

At 1 Credit per post or comment ($0.10 / 1,000 items, up to 100 posts or 200 comments per call), 100,000 items cost $10.00 base PAYG (or $5.75 effective on the Pro plan and $3.98 effective on the Business plan) — up to 80% lower than legacy scraping platforms.

### What is your refund policy?

Payments made within the last 14 days can be refunded up to the unused purchased balance on your account. Promotional signup credits have no cash value.