An agent calls a tool that hits a Reddit data source at request time. With Redditapis that tool is a single REST call with a bearer token, so the agent can search posts, read comment trees, look up users, and send DMs. You can expose those endpoints as direct function calls, as MCP tools, or as a RAG ingestion step.
Reddit data for AI agents
Ground your agent in what people are actually saying. One REST key powers tool calls, MCP servers, and RAG pipelines with live search, posts, comments, and DMs, from $0.002 per call.
Written by Emma, developer relations at Redditapis. We price every grounding call at $0.002 per read (source: our published pricing), so your agent pulls live Reddit context for cents per session.
How do AI agents get Reddit data?
An agent calls a tool that hits a Reddit data source at request time. With Redditapis that tool is one REST call with a bearer token, so the agent can search posts, read comment trees, look up users, and send DMs. Expose those endpoints as direct function calls, wrap them as MCP tools, or batch them into a RAG index, and the agent works from live Reddit context instead of a training cutoff, with the anti-block layer handled for you.
What agents build on Reddit data
Reddit is where people argue, recommend, and complain in the open. That makes it high-signal grounding for an agent, whether it is answering, monitoring, or acting.
Ground answers in real threads
Pull the current discussion on a topic and feed it to the model, so an agent answers from what people said this week, not from a training cutoff.
Research and summarise a subreddit
Search posts and comments, rank by score, and let the agent synthesise the state of a community into a brief with citations back to permalinks.
Monitor for a trigger
Poll search on a keyword or brand, and have the agent decide when a new post crosses a threshold worth acting on. The API is the sensing layer.
Build a RAG index over Reddit
Fetch posts and comment trees, chunk and embed them, and store vectors so the agent retrieves grounded Reddit context at query time.
Act, not just read
Write tools let an agent vote, comment, or send a direct message, so a workflow can close the loop instead of stopping at a recommendation.
Never reason about rate limits
Proxy rotation, retries, and backoff run on our side, so the agent gets clean JSON instead of 403s and never has to plan around being blocked.
Three ways to connect an agent to Reddit
All three use the same key and the same endpoints. Pick the one that fits how your agent is built.
Direct REST tool call
- Define one function per endpoint the agent needs
- The model emits a JSON call, your code fetches, returns JSON
- All 52 endpoints available as callable functions
MCP server
- Wrap the REST endpoints as Model Context Protocol tools
- Works with Claude Desktop, Cursor, and any MCP client
- One server, reused across every agent you build
RAG pipeline
- Batch-fetch posts and comment trees at scale
- Chunk, embed, and store for retrieval at query time
- Refresh on a schedule so the index stays current
From tool call to grounded answer
A read tool feeds the model live context. A batch fetch builds a RAG index. Both are the same endpoints with your key as a bearer token.
JavaScript tool
// Agent tool: fetch fresh Reddit context for the model
async function redditSearch({ q, subreddit, limit = 25 }) {
const url = new URL("https://api.redditapis.com/api/reddit/search");
url.searchParams.set("q", q);
if (subreddit) url.searchParams.set("subreddit", subreddit);
url.searchParams.set("limit", String(limit));
const res = await fetch(url, {
headers: { Authorization: "Bearer YOUR_API_KEY" },
});
const { posts } = await res.json();
// Feed titles + bodies + permalinks back to the model as grounded context
return posts.map((p) => ({ title: p.title, url: p.permalink, upvotes: p.upvotes }));
}Python RAG ingest
# Ingest a subreddit into a vector store for retrieval
import requests
HEAD = {"Authorization": "Bearer YOUR_API_KEY"}
def fetch_posts(subreddit, limit=100):
r = requests.get(
"https://api.redditapis.com/api/reddit/posts",
params={"subreddit": subreddit, "sort": "top", "limit": limit},
headers=HEAD,
)
return r.json()["posts"]
for p in fetch_posts("MachineLearning"):
chunk = f"{p['title']}\n{p.get('text','')}"
store.add(text=chunk, metadata={"url": p["permalink"], "upvotes": p["upvotes"]})New to agent tool design? The guide to tool use and function calling covers the pattern, and the Reddit Search API tutorial walks through the query parameters.
The best Reddit API for AI and LLM training data
For a training corpus, the best Reddit API is one that returns bulk JSON per call, bills per call rather than per year, and lets you re-pull on a schedule so the corpus does not go stale. A corpus build is one large burst of reads, not steady traffic, so an annual contract prices the wrong shape. Redditapis listing endpoints return up to 100 posts or comments per call at $0.002, which puts a one-million-comment corpus at roughly 10,000 calls, or about $20 in API spend, with no annual minimum and no app review in front of it.
The arithmetic scales on the listing endpoints: divide the item count by the page size, then multiply by the per-call rate. At the maximum limit of 100 items per call, 100,000 comments is about 1,000 calls, or $2. One endpoint prices differently and is worth knowing before you plan a budget: deep comment search fans out into a search plus several comment-tree fetches, so it is $0.02 per call and its limit bounds parent posts rather than comments returned. Reddit's own commercial Data API lists a lower headline rate of $0.24 per 1,000 calls, but that rate sits behind a $12,000-a-year Standard tier and an approval queue, so it only beats pay-per-call above a volume most corpus builds never reach.
Two constraints belong in any honest answer here. Reddit content is user-generated and stays subject to Reddit's terms and to each author's rights, so API access is not a content license and a training corpus needs its own legal review. And because posts are edited and deleted, a corpus pulled once drifts away from the live site, which is why teams re-pull on a schedule and keep a permalink and a fetch timestamp on every record.
For the workload breakdown across datasets, sentiment, and agents, see what you can build with the Reddit API, and for per-call rates across every tier see pricing.
Go deeper on the integration you picked
This page is the map. Each path has its own build guide:
- Reddit MCP server , tools for Claude, Cursor, and more
- Reddit Search API , the search endpoint and its parameters
- Get a Reddit API key , instant bearer token, no waitlist
- Pricing , per-call costs for reads and writes
- MCP setup for Claude Code , one command, no config file
- MCP setup for Claude Desktop , 4 steps via the app settings
- MCP setup for Cursor , add the server to mcp.json
- MCP setup for VS Code , wired into the Copilot agent
- MCP setup for Windsurf , Cascade-native setup
- MCP setup for Kilo Code , add the server to kilo.jsonc
- MCP setup for OpenClaw , add the server to openclaw.json
- MCP setup for Hermes Agent , add the server to config.yaml
Frequently asked questions
Yes. The REST endpoints return clean JSON you can chunk, embed, and store in a vector database for retrieval-augmented generation, or batch for a training corpus. Because calls are live, you can refresh the index on a schedule so the agent retrieves current Reddit context instead of a stale snapshot.
For a training corpus the best Reddit API is one that returns bulk JSON per call and bills per call rather than per year, because a corpus build is one large burst, not steady traffic. Redditapis listing endpoints return up to 100 posts or comments per call at $0.002, so a one-million-comment corpus is about 10,000 calls, or roughly $20. The official Reddit Data API gates commercial use behind a $12,000-a-year tier and an app review.
Divide your target item count by the page size, then multiply by $0.002. Listing endpoints return up to 100 items per call, so 100,000 comments is about 1,000 calls, or $2, and one million is about 10,000 calls, or roughly $20. There is no annual minimum and no seat fee, so a one-off corpus build costs only the calls it makes.
Use direct REST function calls for a single agent that needs a few live lookups. Use an MCP server when you want the same Reddit tools reused across Claude, Cursor, and other clients. Use a RAG pipeline when the agent needs to retrieve over a large body of Reddit history rather than a handful of live queries.
Across all 52 endpoints an agent can search posts and comments, pull subreddit listings and full comment trees, look up users, and run write actions like votes, comments, and direct messages. Read tools ground the model, write tools let the workflow act on what it finds.
Not directly. Proxy rotation, retries, and backoff run on our side, so an agent making many calls gets clean JSON instead of 403s. You pay per successful call rather than managing a proxy pool, which keeps the agent logic focused on the task, not on staying unblocked.
You pay per call: reads are $0.002, votes $0.005, writes $0.012, and DMs $0.025. There is no seat or minimum, so an idle agent costs nothing. Every new account starts with $0.50 in free credits, which covers 250 reads before you spend anything.
By the numbers
Reddit data for agents, by the numbers
Every Redditapis figure resolves to our published per-call rates; every external figure is a primary US source.
Redditapis bills reads at $0.002 per call, votes at $0.005, writes at $0.012, and DMs at $0.025, one flat rate for every account with no minimum spend. (Redditapis pricing, 2026)
Every new account starts with $0.50 in free credits and no card on file, enough for roughly 250 grounding reads before any charge. (Redditapis, 2026)
Listing endpoints accept a limit of 1 to 100 items per request, so a one-million-comment training corpus is about 10,000 calls, or roughly $20 at $0.002 per read. (Redditapis API docs, 2026)
Reddit's own commercial Data API is priced at $0.24 per 1,000 API calls, the rate that ended third-party apps like Apollo in 2023. (The Verge, 2023)
Reddit's free Data API tier is capped at 100 queries per minute per OAuth client, and 10 queries per minute without OAuth, so an agent polling at scale needs a managed layer. (Reddit Data API Wiki, 2026)
Reddit signed a reported $60 million-a-year deal to license its data for AI training, a sign of how valuable grounded Reddit context has become for models. (Reuters, 2024)
Keep reading.
Continue exploring related pages.
Reddit API documentation
The complete 2026 reference: auth, all 52 endpoints, and code.
Get a Reddit API key
Instant bearer token, no waitlist and no enterprise contract.
Reddit Responsible Builder Policy
Why Reddit denies API applications, and the managed REST bypass.
Reddit API use cases
14 use cases from AI training to brand monitoring and DMs.
Reddit Search API
Search posts, comments, users, and communities over one REST endpoint.
Reddit MCP server
Wrap the REST API as MCP tools for Claude, Cursor, and any MCP client.
Redditapis pricing
Endpoint-level costs and quick monthly totals - reads from $0.002 / call.
Reddit API cost calculator
Estimate monthly spend using your request volume.
Reddit API guides and tutorials
Tutorials, walkthroughs, and API deep-dives for developers.
Reddit API alternatives
Evaluate alternatives by cost model, limits, and integration fit.
Cheap Reddit API
The cheapest way to get Reddit data: $0.002 per call, no contract, no minimum.
Official Reddit API vs Redditapis
Access, setup, rate limits, and pricing, side by side.
PRAW alternative
A hosted Reddit REST API for any language, no app registration or OAuth.
Reddapi alternative
A maintained Reddit REST API with published pricing and write endpoints.
Reddit comment scraper alternative
The raw comment API: search and filter comments, historical and live, clean JSON.
Reddit scraper API
Hosted scraper API vs building your own: managed proxies, clean JSON.
RapidAPI Reddit alternative
A direct, maintained Reddit API with published pricing and write endpoints.
Bright Data Reddit alternative
A purpose-built Reddit API vs a general scraping platform: structured JSON, plus writes.
ScraperAPI Reddit alternative
A Reddit-native API vs a generic HTML fetcher: auth and pagination handled, typed JSON.
TikHub alternative
TikHub's Reddit surface is read-only; get comment, vote, and DM endpoints too.
EnsembleData alternative
No $100/month floor: pay per call from $0.002, plus write, vote, and DM endpoints.
Scrape Creators alternative
7 read-only Reddit endpoints vs a dedicated API with real write, vote, and DM paths.
FetchLayer alternative
Posts, comments, and search only; add vote, comment, and DM over the same REST auth.
Reddit monitoring API
Build your own keyword and brand-mention monitor: search, comment search, and subreddit streams over REST.
F5Bot vs Redditapis
F5Bot's Slack and Discord delivery needs its $49.99/mo Gold tier; Redditapis includes it from $19/mo.
Syften vs Redditapis
Syften caps you at 100 to 500 results a day; Redditapis allows 10,000 a day per monitor at the entry plan.
Octolens vs Redditapis
Octolens meters by mention with overage fees; Redditapis is flat-priced by subreddit slot from $19/mo.
Affiliate program
Earn 20% lifetime commissions - capped at $5,000/yr.
Reddit Vote API tutorial
Upvote and downvote a post programmatically via the REST API.
Reddit Data API: REST, no PRAW
REST endpoints for Reddit data with no PRAW and no OAuth dance.
Reddit scraping benchmarks
Real throughput, error rates, and cost benchmarks for Reddit scraping.
Reddit API answers
Direct answers on cost, access, rate limits, endpoints, and auth.
How much the Reddit API costs
Per-call pricing from $0.002 a read, with $0.50 in free credits.
Reddit API in Python
One requests call with a bearer token, no PRAW and no OAuth flow.
Reddit shadowban checker
Check if a Reddit account is shadowbanned in seconds, free and no login.
Give your agent live Reddit context.
$0.50 in free credits, no card required. Sign up, copy your bearer token, and make your first grounded tool call in minutes.