Reddit API
11 Reddit endpoints covering posts, popular, subreddits, hot lists and accounts, from $0.002 a call. No Reddit account or cookie needed, and a failed call costs nothing.
Connect your AI
Paste this into your agent
Read https://okdata.online/agents.md and set up okdata for me; my key is in the OKDATA_API_KEY environment variable.
Claude Code, Cursor, Codex and other agents that can open a link set themselves up from it.
MCP serverhttps://api.okdata.online/mcp
Ask about Reddit from Claude, Cursor and other agents: the Reddit MCP page
- Endpoints
- 11 endpoints
- In 5 groups, one response format
- Lowest price
- From $0.002
- A call, paid from a prepaid balance
- Freshness
- Live
- Boards are a shared snapshot up to 10 minutes old
- Failed calls
- $0
- Errors and timeouts are never charged
Every Reddit endpoint
One row per endpoint: the request, what comes back and what one call costs.
Posts
4Popular
1Subreddits
2Hot lists
1Accounts
3Prices are per call unless marked /item. A failed call is not charged.
What people do with Reddit data
Each job has its own page with the endpoints it takes, a worked run and its cost.
Content research
“What do the top posts on this topic have in common?”
- Post search$0.004
- Post detail$0.002
- Community posts$0.004
5 endpoints here, from $0.002How it works
Competitor monitoring
“What did our competitors post this week, and what took off?”
- Post detail$0.002
- Community posts$0.004
- Community profile$0.002
5 endpoints here, from $0.002How it works
Word of mouth
“What do buyers complain about most?”
- Post search$0.004
- Post comments$0.002
2 endpoints here, from $0.002How it works
Trend research
“What is trending today that we could ride?”
- Popular feed$0.002
- Trending searches$0.002
2 endpoints here, from $0.002How it works
Creator discovery
“Who are the mid-size creators in camping gear?”
- User profile$0.002
- User active communities$0.002
2 endpoints here, from $0.002How it works
Transcripts
“Which products did this channel recommend?”
- Video transcript$0.004
1 endpoint here, from $0.004How it works
Start in three steps
The example is Reddit post search; every Reddit endpoint is called the same way and answers in the same shape.
Get a key
Create an account and a key in the console. A new key comes with $0.10 to try, no card.
Connect your AI, or call it yourself
Paste this sentence into Claude Code, Cursor, Codex or another agent that can open a link, and it sets itself up. Or send the request below with your key in the Authorization header.
Set up okdata for me by following https://okdata.online/agents.md. Here is my okdata API key: okd_…. Keep it safe and use it for all okdata calls.
Swap the placeholder for your own key, or sign in and copy it with the key filled in.
Make the first call
Items arrive in data.items (one object in data.item), the next page in page.next_cursor and what you were charged in meta.billing.amount.
cURL
curl -G "https://api.okdata.online/v1/reddit/posts/search" \ -H "Authorization: Bearer $OKDATA_API_KEY" \ --data-urlencode 'query=saturn rings'Python
import os import requests resp = requests.get( "https://api.okdata.online/v1/reddit/posts/search", headers={"Authorization": f"Bearer {os.environ['OKDATA_API_KEY']}"}, params={"query": "saturn rings"}, timeout=60, ) body = resp.json() if body["code"] != "ok": raise RuntimeError(f"{body['code']}: {body['message']} (charged: {body['charged']})") for row in body["data"]["items"]: print(row["id"], row["metrics"]["likes"], row["text"][:60]) print("cost: $" + body["meta"]["billing"]["amount"])TypeScript
const url = new URL('https://api.okdata.online/v1/reddit/posts/search'); url.searchParams.set('query', "saturn rings"); const res = await fetch(url, { headers: { Authorization: `Bearer ${process.env.OKDATA_API_KEY}`, }, }); const body = await res.json(); if (body.code !== 'ok') throw new Error(`${body.code}: ${body.message}`); for (const row of body.data.items) { console.log(row.id, row.metrics.likes, row.text.slice(0, 60)); } console.log('cost: $' + body.meta.billing.amount);MCPtools/call
{ "name": "call", "arguments": { "capability": "reddit.posts.search", "query": "saturn rings" } }
Questions about the Reddit API
What does the Reddit API cost?
Each of the 11 endpoints has its own price, from $0.002 to $0.004 a call; the cheapest is Reddit Popular feed at $0.002. You pay per call from a prepaid balance, with no subscription, and a failed call is not charged.
Do I need a Reddit account or cookie?
No. You call https://api.okdata.online with one okdata key and get public Reddit data back; no Reddit account, cookie or QR login is involved.
How fresh is the data?
Most endpoints read Reddit at the moment you call. Hot lists come from a shared snapshot that is at most 10 minutes old.
Can my AI agent use the Reddit API?
Yes. Connect the MCP server at https://api.okdata.online/mcp: its find tool lists these 11 endpoints with their prices, and its call tool runs them on your key.
Can I try it for free?
New accounts get $0.10 of trial credit with no card: enough for 50 calls to Reddit Popular feed.