How is this different from the official Reddit API?

The official API requires an OAuth app, enforces tight per-client rate limits and charges for meaningful volume since the 2023 pricing changes. The Advanced Reddit API is a flat scraper: pass any public post or subreddit URL with your API Codex key and get JSON back. No app registration, no OAuth, no token refresh.

Do I need a Reddit account or login?

No. The API only scrapes publicly visible pages and never asks for Reddit credentials, cookies or proxies. You authenticate to the API itself with your API Codex key. Private, quarantined or login-gated communities are not accessible.

How fresh is the data?

Every request triggers a live scrape of the page at that moment, so scores, comment counts and subreddit feeds reflect the current state rather than a cached database. That is also why responses take 5-45 seconds instead of milliseconds: you are trading a little latency for data that is never stale.

What does an HTTP 202 response mean and how do I handle it?

If a scrape exceeds the synchronous window, the API returns 202 with a snapshot_id instead of making you wait on an open connection. Poll GET /v1/result?snapshot_id=... until it returns 200 with status "ready" and your data. This mostly happens on /v1/subreddit-posts, where results are typically ready within 1-2 minutes.

How do I discover new posts in a subreddit?

/v1/subreddit-posts takes a subreddit URL like https://www.reddit.com/r/programming and returns up to 50 current posts per call (limit=1-50, default 10), each with title, score, author and comments count. Feed the post URLs you find into /v1/post for the full record, and use fields= to trim each item to just what you need.

Scrape any public post or subreddit feed as clean JSON

Advanced Reddit API

Name: Advanced Reddit API
Brand: API Codex
SKU: advanced-reddit-api

The Advanced Reddit API turns any public Reddit post or subreddit into structured JSON with a single GET request. Post title, body, score, comments count, author and flair, plus subreddit post feeds for discovery, scraped live with no login, OAuth app or proxies on your side.

Since Reddit locked down its official API, third-party access has meant OAuth apps, tight rate limits and per-call pricing negotiations. This Reddit scraper API works on any public post or subreddit: pass a URL with your key and get JSON back. Most requests complete synchronously in 5-45 seconds.

Get a free API key Read the docs

Free tier included, no credit card required. One key works across every API.

Free calls / month: 40
Endpoints: 3
Response Time: 5-45s
Data Freshness: Live

Get your free API key

40 free calls on the free plan

Key features

Any public post or subreddit, no OAuth app registration
Live scraping on every request, no stale cached databases
Post data: title, body, score, comments count, author, flair
Subreddit feeds for discovery with limit control (1-50)
fields= selection to trim responses to just what you need
No Reddit account, cookies or proxies required
Snapshot polling for slow scrapes via /v1/result

Built for

Brand and keyword monitoring across subreddits
Community sentiment and trend research
Content discovery pipelines for newsletters
Market research on niche communities
Datasets for LLM training and analysis

MCP · for your agent

Hand the Advanced Reddit API to your agent

Connect Claude, Cursor or any MCP client once, then ask in plain words. Your agent finds this API, reads its docs and makes the call: 25 credits per call, the same as REST, from your team's balance.

Connect your agent

Mine a community for pain points

“What are people in r/smallbusiness frustrated about with invoicing right now? Pull the current posts and summarize.”

list_apis · get_api_docsfree

api_request GET /reddit/v1/subreddit-posts?url=https://www.reddit.com/r/smallbusiness&limit=50 25 cr

The subreddit's current posts, filtered to invoicing threads and summarized as pain points.

Check on a launch thread

“How is our launch post on r/SaaS doing? Give me its score, upvote ratio and comment count for the launch channel.”

list_apis · get_api_docsfree

api_request GET /reddit/v1/post?url=https://www.reddit.com/r/SaaS/comments/1abc234/we_launched_acme_invoicing 25 cr

Live score, upvote ratio, comment count and flair, posted as a one-line status update.

Source links for a newsletter

“Pick 5 posts from r/homelab this week that would make good newsletter items, with a preview image for each link.”

list_apis · get_api_docsfree

api_request GET /reddit/v1/subreddit-posts?url=https://www.reddit.com/r/homelab&limit=30 25 cr

+ URL Metadata API5 cr

Five high-scoring threads with titles, links, preview images and a one-line angle for each.

$ claude mcp add --transport http apicodex https://mcp.apicodex.io

Illustrative asks; the calls and prices are real. Claude, Cursor, VS Code and Windsurf setup: mcp.apicodex.io

Try it

Build the request for your data

Edit the parameters below and see the exact request and curl command you'd send. No key required to preview.

GET /reddit/v1/post

Open in Playground

Parameters

url

Request · HTTP

GET /reddit/v1/post?url=https://www.reddit.com/r/programming/comments/1abc234/example HTTP/1.1
Host: api.apicodex.io
X-Api-Key: YOUR_API_KEY

Response · JSON 200 OK

{
  "type": "post",
  "url": "https://www.reddit.com/r/programming/comments/1abc234/example",
  "data": {
    "title": "Why we moved our API gateway to the edge",
    "subreddit": "programming",
    "author": "edge_dev",
    "score": 2841,
    "upvote_ratio": 0.94,
    "comments_count": 412,
    "flair": "Discussion",
    "created_at": "2026-08-12T14:03:00Z",
    "body": "After two years on a regional cluster we moved everything to the edge..."
  }
}

Run it with your key

Documentation

Advanced Reddit API Documentation

Pass a Reddit post or subreddit URL and get a complete, structured JSON record back in a single request. All endpoints are GET. On /v1/subreddit-posts, limit accepts 1-50 (default 10), and fields= lets you keep only the top-level fields you need. If a scrape exceeds the sync window you get HTTP 202 with a snapshot_id to resolve via /v1/result.

Base URL

url

https://api.apicodex.io/reddit

Authentication

Create a key at apicodex.io/register and send it as an X-Api-Key header (or an ?apikey= query parameter) on every request. No Reddit account, OAuth app or session cookie is ever involved.

headers

GET /reddit/v1/post?url=https://www.reddit.com/r/programming/comments/1abc234/example
X-Api-Key: YOUR_API_KEY

Request and response

Illustrative values. Confirm current endpoint behavior, quotas, and data freshness in the API documentation before production use.

request · http

GET /reddit/v1/post?url=https://www.reddit.com/r/programming/comments/1abc234/example HTTP/1.1
Host: api.apicodex.io
X-Api-Key: YOUR_API_KEY

response · json

{
  "type": "post",
  "url": "https://www.reddit.com/r/programming/comments/1abc234/example",
  "data": {
    "title": "Why we moved our API gateway to the edge",
    "subreddit": "programming",
    "author": "edge_dev",
    "score": 2841,
    "upvote_ratio": 0.94,
    "comments_count": 412,
    "flair": "Discussion",
    "created_at": "2026-08-12T14:03:00Z",
    "body": "After two years on a regional cluster we moved everything to the edge..."
  }
}

Code examples

cURL

curl --request GET \
  --url 'https://api.apicodex.io/reddit/v1/post?url=https://www.reddit.com/r/programming/comments/1abc234/example' \
  --header 'X-Api-Key: YOUR_API_KEY'

JavaScript/Node.js

const url = new URL('https://api.apicodex.io/reddit/v1/post');
url.searchParams.set('url', 'https://www.reddit.com/r/programming/comments/1abc234/example');

const res = await fetch(url, {
  headers: {
    'X-Api-Key': 'YOUR_API_KEY'
  },
});
console.log(await res.json());

Python

import requests

url = "https://api.apicodex.io/reddit/v1/post"
querystring = {"url": "https://www.reddit.com/r/programming/comments/1abc234/example"}
headers = {
    "X-Api-Key": "YOUR_API_KEY"
}
print(requests.get(url, headers=headers, params=querystring).json())

Available Endpoints

GET /v1/post

Scrape a post by URL: title, body, score, upvote ratio, comments count, author, flair.

/v1/post?url=https://www.reddit.com/r/programming/comments/1abc234/example

GET /v1/subreddit-posts

List the current posts of a subreddit as an array for discovery, with limit control.

/v1/subreddit-posts?url=https://www.reddit.com/r/programming&limit=25

GET /v1/result

Fetch a pending result using the snapshot_id from a 202 response.

/v1/result?snapshot_id=s_abc123

Request Parameters

Required parameters

url Reddit URL to scrape: a post URL on /v1/post, a subreddit URL on /v1/subreddit-posts.

Optional parameters

fields Comma-separated top-level fields to keep, e.g. fields=title,score,comments_count. Applies to every item on list endpoints.
limit Max items on /v1/subreddit-posts (1-50, default 10).
snapshot_id /v1/result only: the id returned by a 202 response.

Pricing

Advanced Reddit API Pricing

This API costs 25 credits per request. Credits are shared across every API on your plan.

Estimate your monthly cost

Drag the slider to match your expected request volume. We'll recommend the cheapest plan that covers it.

Requests per month 10,000

Recommended plan

Starter

$29.99 /month

Credits used

Credits included

Cost per 1K requests

Choose Starter

Free

1,000 credits · ~40 requests/mo · 2 rps

All APIs included
No credit card required
Full documentation and examples
MCP server for your AI agents
Up to 5 active API keys

Start for free

Starter

Popular

$29.99 /month

50,000 credits · ~2,000 requests/mo · 10 rps

All APIs included
Email support
Usage dashboard and analytics
MCP server for your AI agents
Up to 5 active API keys

Start with Starter

Pro

$99.99 /month

250,000 credits · ~10,000 requests/mo · 25 rps

All APIs included
Priority support
MCP server for your AI agents
Up to 5 active API keys

Start with Pro

FAQ

Advanced Reddit API

Key features

Built for

Hand the Advanced Reddit API to your agent

Mine a community for pain points

Check on a launch thread

Source links for a newsletter

Build the request for your data

Advanced Reddit API Documentation

Base URL

Authentication

Request and response

Code examples

Available Endpoints

GET /v1/post

GET /v1/subreddit-posts

GET /v1/result

Request Parameters

Required parameters

Optional parameters

Advanced Reddit API Pricing

Free

Starter

Pro

Need a different plan?

Frequently asked questions

Related APIs