Unofficial · Third-party API14 endpoints livenpm@subscraper/sdk on npm↗

Reddit data.
Without the headache.

SubScraper delivers clean, structured JSON from Reddit's posts, communities, and user profiles. Say goodbye to broken HTML parsers, strict rate limits, and fragile scraping infrastructure.

Instant access · 30 free calls to prototype · No credit card required

POST /api/v1/search
200 OK1.2s

Request

$ curl -X POST subscraper.dev/api/v1/search \
  -H "Authorization: Bearer sk-..." \
  -d '{"query": "best mechanical keyboard", "sort": "top"}'

Response

{
  "results": [{
    "title": "What's the best quiet switch for an office?",
    "subreddit": "MechanicalKeyboards",
    "score": 412,
    "numComments": 89
  }]
}
Looking for comment trees or user profiles?Explore interactive examples live↓

Trusted by developers & AI Agents worldwide

14,285,090Requests Served
99.9%Uptime SLA
~120msAvg Latency
1,240+Active Developers
Verified Developer Feedback
“We plugged SubScraper's MCP server into Cursor and our AI agent was pulling live r/SaaS and r/MachineLearning threads in 2 minutes. Easily saved our team at least 40+ engineering hours writing custom scrapers and handling IP rotation.”
DC
David Chen
AI Engineer & Founder
MCP in Cursor

Native integration with modern AI & developer tools

CursorCursorClaudeClaude
OpenAIOpenAI
LangChainLangChain
Next.jsNext.js
TypeScriptTypeScript
Node.jsNode.js
PythonPython
npmnpm
QUICKSTART GUIDE

How to use SubScraper in 3 steps

From zero to live structured Reddit data in under 3 minutes. No Reddit account approval, no OAuth token refreshes.

01Step One · Account Setup

Create your account & get your API key

Sign up in under 30 seconds to generate your private API key. Includes 30 free requests instantly to test all 14 endpoints without a credit card.

  • Instant key generation — zero approval wait time
  • 30 free calls ready to prototype every endpoint
  • No credit card required
API Keys · SubScraper Console
Hobby Plan
Secret API Key
sk_live_948f2a••••••••••••8c1eActive
Credits Quota30 / 30 Free Calls
Rate limit: 10 req/sCredits never expire
02Step Two · Integration

Install the SDK or use raw REST

Install our typed TypeScript SDK or make direct JSON POST requests with any HTTP client. Zero runtime dependencies across Node.js, Bun, Deno, and Next.js.

  • Full TypeScript types & autocompletion
  • Standard JSON POST API compatible with any language
  • Zero external runtime dependencies
View on npm↗
$ npm install @subscraper/sdk
+ @subscraper/sdk@1.0.4
✓ added 1 package in 420ms
03Step Three · Execution

Make your first call & get clean JSON

Call any endpoint to receive clean, predictable JSON with automatic comment tree parsing and built-in proxy rotation.

  • All 14 public Reddit endpoints available
  • Deeply nested comment trees structured cleanly
  • Automated proxy rotation & anti-ban protection
quickstart.ts
200 OK · 118ms
import { SubScraperClient } from '@subscraper/sdk';

const client = new SubScraperClient({
  apiKey: process.env.SUBSCRAPER_API_KEY!,
});

// Search posts across all public subreddits
const data = await client.searchPosts({
  query: 'best mechanical keyboard',
  sort: 'top', limit: 5,
});

console.log(data.results[0].title);
// ✓ "What switch is best for quiet typing?"

Ready to test it in your application?

Get 30 free calls immediately — plenty of quota to build your entire prototype. No credit card required.

Get API key free

The smarter alternative

Why developers build with SubScraper

Skip enterprise contract lock-in, brittle HTML parsers, and IP blocks. SubScraper gives your apps and AI agents reliable structured data at developer-friendly pricing.

10x More Affordable than Enterprise Contracts

Access structured Reddit data without thousands in minimum monthly commitments. Prototype free, then pay transparently as you scale.

Zero Maintenance & No Broken Parsers

Never waste engineering sprints updating HTML selectors when Reddit changes markup. We handle schema normalization and deliver typed JSON.

Built-in Proxy Rotation & Anti-Ban Resiliency

Forget managing residential proxy pools, CAPTCHA challenges, and 429 rate limits. Every request runs through our automated resilient infrastructure.

API reference

One base URL. Fourteen endpoints.

All public data. POST with JSON body, get JSON back. Auth via Bearer token.

EndpointCategory
search→Search
post→Content
community-posts→Community
community-details→Community
user-profile→User
user-posts→User
user-comments→User
search-communities→Search
search-users→Search
comment-permalink→Content
popular→Discover
leaderboard→Discover
resolve-url-type→Utility
explore→Discover
Base: POST /api/v1/{endpoint}All params optional except where notedPagination via page param
View full documentation & schemas →

TypeScript / JavaScript? Use the open-source SDK:

npm@subscraper/sdk on npm↗
Live · MCP & agents

Your AI agents will love this.

Add one simple configuration and your AI assistant can fetch real-time Reddit discussions, threads, and profiles. No custom wrappers or complex SDKs needed — just instant integration.

No wrapper code — all 14 endpoints exposed as tools
Works with Cursor, VS Code, Windsurf, Claude, Cline
Official & maintained — not a community script
Free to install — uses same API credits

Works with every MCP-compatible tool

mcp.json
JSON
{
  "mcpServers": {
    "subscraper": {
      "url": "https://mcp.subscraper.dev",
      "headers": {
        "Authorization": "Bearer sk-..."
      }
    }
  }
}
agent chat · using subscraper
Y
Can you find what people on Reddit think about "React Server Components", and show me the top 5 posts?

Using subscraper.search

I found 5 posts. The most popular one is "Are React Server Components worth the hype?" with 280 comments in r/reactjs...

Interactive API

Request in, structured JSON out.

Every endpoint works the same way. POST with a JSON body, get typed JSON back. Explore the examples below.

POST/api/v1/search
200 OK

Request Body

{
  "query": "indie hacker marketing",
  "sort": "top",
  "limit": 10
}

Response (200 OK)

{
  "results": [
    {
      "title": "How I got my first 100 paying users",
      "subreddit": "SaaS",
      "score": 1204,
      "numComments": 185
    }
  ],
  "total": 3105,
  "took_ms": 115
}

Pricing

Start free. Scale as you grow.

Prepaid credit packs that never expire. Or go unlimited with a Pro subscription.

Hobby

$0/mo

Free forever for experimenting and personal projects.

  • 30 free requests
  • All 14 endpoints
  • MCP server access
  • No credit card required

Starter

$1.99/ 1k reqs

One-time purchase. Credits never expire.

  • 1,000 prepaid requests
  • Credits stack & never expire
  • All 14 endpoints
  • MCP server access

Growth

$17.90/ 10k reqs

One-time purchase. Credits never expire.

  • 10,000 prepaid requests
  • Credits stack & never expire
  • All 14 endpoints
  • MCP server access

Pro

Best Value
$149/mo

For production apps needing a fixed monthly budget.

  • 100,000 requests/mo
  • Resets every month
  • Premium residential proxies
  • Priority support

FAQ

Common questions.

Start fetching Reddit data today

Access our free tier immediately without a credit card. Get integrated in minutes.