Reddit Scraper & API Client for JavaScript / TypeScript

The official JavaScript & TypeScript SDK for the FetchLayer Reddit API.

Search posts. Scrape comments. Pull subreddit data. Get user profiles. All as clean JSON from a single API — no scraping infrastructure, no proxies, no HTML parsing.

Open-source SDK, hosted API. This package is MIT-licensed. The API requires a free FetchLayer API key — no subscriptions, no contracts, no lock-in. Pay only for what you use.

Install

npm install @fetchlayer/reddit

pnpm add @fetchlayer/reddit

yarn add @fetchlayer/reddit

Get your API key

1. Go to fetchlayer.dev
2. Sign in with your email
3. Copy your API key from the dashboard

That's it. No credit card. No trial expiration. You get free requests to start, then pay-as-you-go at $1.99 per 1,000 requests when you need more.

Quick start

import { FetchLayerReddit } from "@fetchlayer/reddit";

const reddit = new FetchLayerReddit({
  apiKey: process.env.FETCHLAYER_API_KEY!,
});

// Search Reddit for posts about any topic
const results = await reddit.searchPosts({
  query: "best CRM tools",
  sort: "top",
  time: "month",
  limit: 10,
});

console.log(results);

That's 4 lines to get structured Reddit data. No OAuth, no rate-limit wrestling, no broken scrapers.

Why use this instead of scraping Reddit yourself

| Problem | FetchLayer | | --- | --- | | Reddit blocks your IP | We handle rotation and resilience | | HTML structure changes break your parser | You get stable JSON | | Reddit API has strict OAuth + rate limits | Simple Bearer token, no rate limits | | Maintaining scraping infra is a full-time job | npm install and done | | You need comments, users, AND search | 13 endpoints, one SDK |

All methods

const reddit = new FetchLayerReddit({ apiKey });

| Method | What it does | | --- | --- | | reddit.searchPosts(params) | Search Reddit posts by keyword | | reddit.getPost(params) | Get a post with its full comment tree | | reddit.getCommentPermalink(params) | Get a specific comment thread | | reddit.getCommunityPosts(params) | List posts from any subreddit | | reddit.getCommunityDetails(params) | Get subreddit metadata and stats | | reddit.getUserProfile(params) | Get a Reddit user's profile | | reddit.getUserPosts(params) | List all posts by a user | | reddit.getUserComments(params) | List all comments by a user | | reddit.searchCommunities(params) | Find subreddits by keyword | | reddit.searchUsers(params) | Find Reddit users by name | | reddit.getPopularPosts(params) | Get what's trending on Reddit | | reddit.getLeaderboard(params) | Get top communities by activity | | reddit.resolveUrlType(params) | Detect what a Reddit URL points to |

Examples

Search posts across Reddit

const posts = await reddit.searchPosts({
  query: "side project ideas",
  subreddit: "startups", // optional — omit to search all of Reddit
  sort: "relevance",
  time: "week",
  limit: 25,
});

Get a full post with comments

const thread = await reddit.getPost({
  url: "https://www.reddit.com/r/webdev/comments/abc123/my_post/",
  commentLimit: 100,
  commentDepth: 4,
});

Browse a subreddit

const hot = await reddit.getCommunityPosts({
  subreddit: "javascript",
  sort: "hot",
  limit: 25,
});

Look up a user

const profile = await reddit.getUserProfile({ username: "spez" });
const posts = await reddit.getUserPosts({ username: "spez", limit: 10 });
const comments = await reddit.getUserComments({ username: "spez", limit: 10 });

Discover trending content

const popular = await reddit.getPopularPosts({ time: "day", limit: 10 });
const topCommunities = await reddit.getLeaderboard({ limit: 10 });

Error handling

import { FetchLayerReddit, FetchLayerError } from "@fetchlayer/reddit";

try {
  const posts = await reddit.searchPosts({ query: "test" });
} catch (err) {
  if (err instanceof FetchLayerError) {
    console.error(err.status); // 401, 429, etc.
    console.error(err.message); // Human-readable error from the API
  }
}

Configuration

const reddit = new FetchLayerReddit({
  apiKey: "your-key",     // Required
  baseUrl: "...",         // Default: https://fetchlayer.dev/api/reddit
  timeoutMs: 30000,      // Default: 30s
  fetch: customFetch,    // Default: global fetch (Node 18+)
});

What this package is

• Zero dependencies — uses native fetch, nothing else
• Dual build — ESM + CommonJS, works everywhere
• Fully typed — TypeScript declarations included
• Tiny — under 6 KB bundled
• Open source — MIT license, contributions welcome

How it works

You call FetchLayer → FetchLayer returns structured Reddit data as JSON → you use it however you want.

No Reddit account needed. No OAuth setup. No scraping infrastructure on your end.

Pricing

| | | | --- | --- | | Free tier | Included with every account — start building immediately | | Pay-as-you-go | $1.99 per 1,000 requests. Credits never expire. | | Subscriptions | Available for heavy use — predictable pricing at scale | | Rate limits | None |

No credit card required to start. No monthly commitment. No overages. Get your API key →

Use cases

• Market research — find what people say about your product or competitors on Reddit
• Lead generation — discover posts where people ask for solutions you offer
• Content research — find trending topics and discussions in your niche
• Sentiment analysis — pull comments and run NLP on real user opinions
• Competitive intelligence — monitor mentions of any brand or product
• AI agents — give your LLM real-time Reddit context via FetchLayer's MCP server

Links

| | | | --- | --- | | Get API key | fetchlayer.dev/signin | | Product page | fetchlayer.dev/reddit-scraper | | Homepage | fetchlayer.dev | | npm | @fetchlayer/reddit | | Issues | GitHub Issues |

License

MIT — see LICENSE.