Reddit contains valuable data — posts, comments, subreddits, authors, and more. Scraping this data directly means dealing with anti-bot detection, CAPTCHAs, IP rotation, and constantly breaking selectors. The Scavio API handles all of that and returns clean, structured JSON from a single POST request.
This tutorial shows you how to scrape Reddit using TypeScript and the Scavio API. By the end, you will have a working TypeScript script that fetches real-time Reddit data and parses the results.
Prerequisites
- TypeScript installed on your machine
- A Scavio API key (free tier includes 500 credits/month — no credit card required)
Step 1: Install Dependencies
Install fetch to make HTTP requests:
npm install typescript tsxStep 2: Make Your First Reddit Search
Send a POST request to the Scavio Reddit API endpoint with your query. The API returns structured JSON with posts, comments, subreddits, and more.
const API_KEY = "your_scavio_api_key";
interface RedditResult {
search_metadata: { status: string };
data: { searchQuery: string; totalResults: number; nextCursor: string | null; posts: Array<{ position: number; id: string; title: string; url: string; subreddit: string; author: string; timestamp: string; nsfw: boolean }> };
}
const response = await fetch("https://api.scavio.dev/api/v1/reddit/search", {
method: "POST",
headers: {
"x-api-key": API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({ query, sort: "new" }),
});
const data: RedditResult = await response.json();
for (const post of data.data?.posts?.slice(0, 5) ?? []) {
console.log(`r/${post.subreddit} — ${post.title}`);
console.log(` by u/${post.author}`);
}Step 3: Example Response
The API returns structured JSON. Here is an example response for a Reddit search:
{
"data": {
"searchQuery": "best python web frameworks 2026",
"totalResults": 14,
"nextCursor": "eyJjYW5kaWRhdGVzX3JldH...",
"posts": [
{
"position": 0,
"id": "t3_1smb9du",
"title": "FastAPI vs Django in 2026 — what the teams are actually using",
"url": "https://www.reddit.com/r/Python/comments/1smb9du/fastapi_vs_django/",
"subreddit": "Python",
"author": "python_dev",
"timestamp": "2026-04-15T16:34:40.389000+0000",
"nsfw": false
}
]
},
"response_time": 5200,
"credits_used": 2,
"credits_remaining": 498
}Every field is structured and typed — no HTML parsing, no CSS selectors, no regex extraction. Your TypeScript code can access any field directly.
Step 4: Full Working Example
Here is a complete, runnable TypeScript script that searches Reddit and prints the results:
/**
* Scrape Reddit search results with full type safety.
* Run with: npx tsx reddit-search.ts
*/
const API_KEY = process.env.SCAVIO_API_KEY!;
interface RedditResult {
search_metadata: { status: string };
data: { searchQuery: string; totalResults: number; nextCursor: string | null; posts: Array<{ position: number; id: string; title: string; url: string; subreddit: string; author: string; timestamp: string; nsfw: boolean }> };
}
async function searchReddit(query: string): Promise<RedditResult> {
const response = await fetch("https://api.scavio.dev/api/v1/reddit/search", {
method: "POST",
headers: {
"x-api-key": API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({ query, sort: "new" }),
});
if (!response.ok) {
throw new Error(`Scavio API error: ${response.status}`);
}
return response.json();
}
const results = await searchReddit("best python web frameworks 2026");
console.log(JSON.stringify(results, null, 2));Why Use Scavio Instead of Scraping Reddit Directly?
- No proxy management. Direct scraping requires rotating proxies to avoid IP bans. Scavio handles all of this server-side.
- No CAPTCHA solving. Reddit aggressively blocks automated requests. Scavio returns clean data every time.
- Structured JSON output. No HTML parsing or CSS selector maintenance. Get typed, consistent data from every request.
- Multi-platform in one API. Search Google, Amazon, YouTube, and Walmart from the same API key with the same authentication pattern.
- Free tier included. 500 credits/month with no credit card required. Each search costs 1 credit.