Reddit's 2023 API pricing change made bulk Reddit access prohibitively expensive for most startups. Scavio's Reddit endpoint returns public Reddit posts, comments and subreddits as JSON with no OAuth and no per-app rate caps. This tutorial walks through the common patterns: post search, comment threads, and subreddit monitoring.
Prerequisites
- Python 3.10+
- A Scavio API key
- A subreddit or query target
Walkthrough
Step 1: Search posts by query
Scavio returns Reddit posts ranked by relevance or recency.
Python
import requests, os
API_KEY = os.environ['SCAVIO_API_KEY']
def search(query, time='month'):
r = requests.post('https://api.scavio.dev/api/v1/reddit/search',
headers={'Authorization': f'Bearer {API_KEY}'},
json={'query': query})
return r.json()["data"].get('results', [])Step 2: Pull comments for a thread
Pass the post URL or id.
Python
import requests, os
API_KEY = os.environ['SCAVIO_API_KEY']
H = {'Authorization': f'Bearer {API_KEY}', 'Content-Type': 'application/json'}
def comments(post_id):
# post_id is the fullname (t3_...) or bare id from a search result.
r = requests.post('https://api.scavio.dev/api/v1/reddit/post/comments',
headers=H, json={'post_id': post_id})
r.raise_for_status()
return r.json()['data'].get('comments', [])
for c in comments('t3_1v6ngaf')[:5]:
print(c['author'], '-', c['text'][:80])Step 3: Monitor a subreddit
New posts in r/MachineLearning every hour.
Python
def watch(subreddit):
r = requests.post('https://api.scavio.dev/api/v1/reddit/search',
headers={'Authorization': f'Bearer {API_KEY}'},
json={'query': f'subreddit:{subreddit}'})
return r.json()["data"].get('results', [])[:25]Step 4: Filter for buyer intent
Regex for 'looking for', 'recommend', 'alternative'.
Python
import re
BUYER = re.compile(r'\b(looking for|recommend|alternative to|help me)\b', re.I)
def intent(posts):
return [p for p in posts if BUYER.search(p.get('title', '') + p.get('selftext', ''))]Step 5: Write to a CSV for SDRs
One row per intent signal.
Python
import csv
def export(posts):
with open('reddit_intent.csv', 'w') as f:
w = csv.DictWriter(f, fieldnames=['title', 'url', 'subreddit'])
w.writeheader(); w.writerows(posts)Python Example
Python
import os, requests
API_KEY = os.environ['SCAVIO_API_KEY']
def reddit(query):
r = requests.post('https://api.scavio.dev/api/v1/reddit/search',
headers={'Authorization': f'Bearer {API_KEY}'},
json={'query': query})
return r.json()["data"].get('results', [])
for p in reddit('looking for serp api')[:10]:
print(p['title'], p['url'])JavaScript Example
JavaScript
const API_KEY = process.env.SCAVIO_API_KEY;
export async function reddit(query) {
const r = await fetch('https://api.scavio.dev/api/v1/reddit/search', {
method: 'POST',
headers: { 'Authorization': `Bearer ${API_KEY}`, 'Content-Type': 'application/json' },
body: JSON.stringify({ query })
});
return (await r.json()).data.results;
}
const posts = await reddit('looking for serp api');
console.log(posts.slice(0, 10));Expected Output
JSON
25 posts per subreddit watch, filtered to ~3-5 buyer-intent signals. Typical SDR workflow: 10 minutes/day, 5-15 qualified leads per week.