Reddit API for AI Agents
Search Reddit posts or pull a full post with its threaded comments in structured JSON. Give your agents community-grounded context for research, brand monitoring, and RAG.
500 free credits per month. No credit card required.
Two endpoints, one API key
Search broadly across Reddit, or zoom into a single post and its full comment tree. Both cost 2 credits per call.
Post Search
POST /api/v1/reddit/searchSearch Reddit posts by query. Sort by relevance, hot, top, new, or comments. Pagination via cursor token. Response includes subreddit, author, timestamp, score, and NSFW flag.
Post Detail
POST /api/v1/reddit/postPass a full Reddit post URL. Get the post body plus the full threaded comment tree. Each comment exposes a depth field so you can render it as-is or rebuild the hierarchy.
Structured JSON, no scraping
Skip HTML parsing and proxy management. One call, clean data.
import requests
response = requests.post(
"https://api.scavio.dev/api/v1/reddit/search",
headers={"Authorization": "Bearer sk_live_your_key"},
json={"query": "best python web frameworks 2026", "sort": "new"},
timeout=30,
)
data = response.json()
for post in data["data"]["posts"][:5]:
print(f"r/{post['subreddit']} -- {post['title']}")
print(f" by u/{post['author']}")Structured Posts
Every post returns with id, title, url, subreddit, author, score, upvoteRatio, numComments, timestamp, flair, NSFW flag, and awards.
Threaded Comments
Comment endpoint returns the full tree with a depth field and parentId on each comment -- reconstruct the thread or render flat.
Any Subreddit
Covers all public subreddits. Scope by including r/name in the query, or search across Reddit globally.
Cursor Pagination
Response includes nextCursor. Pass it back to keep paging. When it's null, you have reached the end.
No Proxy Setup
We handle residential proxies, JS rendering, and rate management. You get JSON.
LangChain + MCP Ready
Use ScavioRedditSearch and ScavioRedditPost in langchain-scavio, or search_reddit and get_reddit_post via the Scavio MCP server.
Built for community-grounded AI
Brand & Mention Monitoring
Search Reddit for mentions of your product, competitors, or category. Pull the full threads to read the actual conversation and not just headlines.
RAG & Answer Engines
Ground LLM answers in what practitioners actually say. Pipe Reddit threads into your retrieval index to give answers real texture, not marketing copy.
Product & Market Research
Scan r/startups, r/entrepreneur, r/ecommerce, r/marketing, or your vertical's home subreddit for trends, pain points, and demand signals.
Sentiment & Review Analysis
Pull comments at depth, pass them to an LLM for sentiment scoring, and aggregate at the post or subreddit level.
Popular subreddits for agents
Scope your query or cover them all -- the API does not care.
Frequently asked
How do I search Reddit with Scavio?
Send a POST request to /api/v1/reddit/search with a JSON body containing 'query' and optionally 'sort' (relevance, hot, top, new, comments) and 'cursor' for pagination. Scavio returns an array of posts with subreddit, author, score, timestamp, and NSFW flag.
How do I fetch a Reddit post with its comments?
Send a POST request to /api/v1/reddit/post with the full Reddit post URL. Scavio returns the post object plus a flat array of comments, each with a 'depth' field and 'parentId' so you can reconstruct the threaded tree.
How long do Reddit requests take?
Reddit requests take 5-15 seconds. They are slower than our other platforms because they use JavaScript rendering and premium residential proxies to get fresh results. Use a client timeout of at least 30 seconds and show skeleton or progress UI.
How much do Reddit endpoints cost?
Both the search and post endpoints cost 2 credits per request. The free tier includes 500 credits per month, so you can make 250 Reddit requests per month at no cost. No credit card required to start.
Does Scavio support pagination on Reddit search?
Yes. The search response includes a 'nextCursor' token. Pass it as the 'cursor' parameter on your next call to fetch the next page of posts. When nextCursor is null, there are no more results.
Can I filter out NSFW posts?
Each post in the response includes an 'nsfw' boolean. Filter results client-side based on this flag. For typed LangChain / MCP integrations the same field is exposed on the structured output.
Which subreddits does the API cover?
All public subreddits. Passing a query like 'site:reddit.com/r/programming fastapi' is not required -- the search already indexes all of Reddit. If you want subreddit-scoped results, include the subreddit name in the query (e.g. 'r/python fastapi').
Related
Google Search API
Structured SERP data with knowledge graph, PAA, and AI overviews.
YouTube Transcript API
Search videos, extract transcripts and metadata for RAG.
Amazon Product API
Real-time pricing, ratings, and reviews across 12 marketplaces.
Walmart Product API
Product search with pricing, ratings, and fulfillment data.